PARTI 

PDP-15/10 SOFTWARE SYSTEM 

INTRODUCTION 



1.1 GENERAL 

Software for the PDP-15/10 consists of the COMPACT and the BASIC I/O Monitor Software Systems, which are 
designed to operate in a paper tape (or card) environment. 



l.Ll COMPACT System 

COMPACT is a complete programming system for the PDP-15/10 and includes a symbolic assembler, text editor, 
debugging routine, various utiUty routines, and a library of mathematical routines. With COMPACT software, the user 
can prepare symbohc programs on-hne using the Text Editor, assemble them using the CAP-15 Assembler, and 
execute them under the control of the debugging routine (ODT), The utihty and mathematical routines in the system 
can be incorporated into user programs as required. With the addition of a DECtape transport and control unit, users 
can use the FAST- 15 System to store and retrieve frequently used system and user programs. In addition, users can 
convert PDP-8 programs (PAL-D, PAL-III, or MACRO-8) to PDP-15 assembly language with the aid of 8TRAN. 



1.1.2 Basic I/O Monitor System 

The more sophisticated Basic I/O Monitor Software System, available to users with expanded PDP-15/10 Computers 
(Refer to Table 1-1), is a complete system for the preparation, compilation, assembly, debugging, and operation of 
relocatable programs. 

Powerful system programs include FORTRAN IV, FOCAL, a sophisticated macro assembler (MACRO- 15), an on-line 
debugging system (DDT), an on-line editor (EDIT- 15), and a peripheral interchange program (PIP). A versatile and 
flexible input-output programming system (lOPS) frees the user from the need to create device handling subroutines 
and from the concerns of device timing. The Basic I/O Monitor is upward compatible with the Advanced and 
Background/Foreground Monitors of the PDP-15 series; thus, all programs prepared for the Basic I/O Monitor can be 
run using the Advanced or Background/Foreground Monitors. In addition, users having PDP-8 programs (PAL-D, 
PAL-III or MACRO-8) may convert them to PDP-1 5 assembly language with the aid of 8TRAN. 
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t . 1. 3 Hardware Requ irements 

Minimum hardware configurations applicable to the COMPACT and Basic I/O Monitors are provided in Table 1-1. 

1.2 COMPACT SYSTEM PROGRAMS 

The COMPACT System consists of the programs described in the following paragraphs, 

1.2.1 Assembler 

The PDP-15/10 Assembler (CAP-15) is a two-pass assembler that requires less than 3K of core memory. It processes 
source programs to produce an executable binary code. The Assembler makes machine language programming easier, 
faster, and more efficient. It permits the programmer to use mnemonic symbols to represent instruction operation 
codes, locations, and numeric data. The programmer can direct the Assembler's processing by means of a powerful set 
of pseudo operations. An output listing that shows the programmer's source coding, as well as the binary object code 
produced by the Assembler, can be obtained. 

1.2.2 Text Editor 

The Text Editor provides for the creation/modification of source programs and other ASCII text material. Commands 
issued from the teletype direct the Editor to bring a group of lines from the input device to an internal buffer. The 
user can then, by means of additional commands, examine, delete, and change the contents of the buffer, and insert 
new text at any point in the buffer. When a block of lines has been edited, it is punched on the output device. 

The Editor is most frequently used to modify PDP-15/10 source programs, but it can also be used to edit any 
symbolic text. The Editor operates with either high-speed or low-speed paper tape devices, and occupies 
approximately 2000i o locations of core memory. Any additional memory is used for buffers. 

Table M, PDP-15/10 Hardware Configurations 



^^^^ PDP-15/10 Hardware 


Basic 4K System 


Expanded 8K System* 


^^V^o nf iguration 

Applicable ^^x^^^ 
Software ^^^^ 


ASR33 


ASR33 
DEC tape 


ASR 33 

High-speed 

Reader/punch 


ASR 33 

High-speed 

Reader/punch 

DEC tape 


COMPACT 


V 


V 


V 


V 


COMPACT 




V 




V 


FAST 15 






BASIC I/O 






V 


V 


MONITOR 







*Additional options include the CR03B Card Reader, the 647D or 647F Line Printer, and the TU20, TU20A, TU30, and TU30A 
Magnetic Tape Transports. 
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1.2.3 Debugging Routine 

Octal Debugging Technique (ODT) is a debugging aid that allows the user to conduct an interactive, on-line debugging 
session using octal numbers and teletype commands. When errors are found, the programmer can correct them on-line 
and execute the program immediately to test the correction. Thus, ODT can be used to compose a program on-line 
and check it out as composition progresses. Manual operation of console controls is not required to operate ODT; all 
functions are initiated by typing commands on the teletype. 



1.2.4 Utility Routines 

UtiHty routines in the COMPACT Software System include a FAST- 15 system for DECtape handling, a hardware 
readin mode (HRM) punch routine, paper-tape handling routines, teletype I/O routines, an octal dump routine, and a 
memory scan routine. These routines are briefly described in the following paragraphs. 

1.2.4.1 FAST-15 System - FAST-15 (Fast Acquisition of System Tape) is a loading system used to retrieve 
frequently used programs from DECtape and to create system tapes. The main advantages of the system are speed and 
ease of access. Equipment required for use of FAST-15 includes a Type TC02 DECtape Control Unit and a Type 
TU55 DECtape Transport. 

The FAST-15 system tape, as distributed by Digital Equipment Corporation, contains commonly used system 
programs such as the Symbolic Editor, the CAP- 15 Assembler, and ODT. Since these programs can be called from 
DECtape with only a small bootstrap, paper tape handling is eliminated. FAST-15 is not restricted to system 
programs; it also can be employed very conveniently for frequently accessed user programs. 

1.2.4.2 HRIVI Puncher - The Hardware Readin Mode (HRM) Puncher is a self -relocating, paper tape dump program. 
It can be loaded by means of the PDP-15/10 Hardware Readin (HRI) facility into any block of core memory. When 
loaded, the HRM Puncher relocates itself and punches out an area of memory, specified by the user, in the HRI 
format. 

1.2.4.3 Paper Tape Handling Routines - The paper tape handling routines include PTLIST, a paper tape list and 
PTDUP, a paper tape dupUcator. PTLIST can be used to read an ASCII coded paper tape from either the high-speed 
or low-speed paper tape reader, and provide a character-by-character listing on the teletype. PTDUP can be used to 
duplicate/verify ASCII or binary tapes using the high-speed paper tape reader and punch. 

1.2.4.4 Teletype Input/Output Routines - The teletype input/output routines include the Teletype I/O Conversion 
(TICTOC) Package and the Decimal and Octal Print Package. 

TICTOC is used to read 8-bit ASCII code from the teletype and pack it as a 6-bit trimmed ASCII code, and vice versa. 
Routines in the package fall into three main categories: input, output, and formatting. 

The decimal and octal print routines are subroutines that can be used to dump the accumulator in either 
signed-decimal or octal format. 

1.2.4.5 Octal Dump Routine - The octal dump routine allows the user to obtain hard copy or paper tape output 
showing the contents of any register or set of registers that he specifies. The user specifies the registers that are to be 
dumped via the teletype keyboard. 
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1.2.4.6 SCAN Routine - SCAN is a small program used to scan areas of memory for a particular bit configuration. 
The user specifies the start and stop address for the area to be scanned, the bit configuration to look for, and the bit 
positions to be tested. When scanning the area, if a match is found, the address of the match and the matching word 
are printed. 



1.2.5 Mathematical Routines 

The COMPACT Software System mathematical routines are grouped into four major packages: Integer Arithmetic, 
Trigonometric Functions, Floating Point, and Floating Point I/O. The Integer Arithmetic routines allow PDP-15/10 
users, without the EAE option, to write programs using simulated multiply and divide instructions. The 
Trigonometric Package provides the user with a large repertoire of trigonometric functions in both single- and 
double-precision. The Floating Point Package allows the user with the capability of inputting and outputting decimal 
data in floating point format. All floating point data transfers are handled through a software accumulator. 



1.2.6 8TRAN 

8TRAN is used to translate programs written in Pal III, Pal-D, or MACRO-8 assembly language to MACRO- 15 
assembly language for assembly and execution in the PDP-15 Basic Software environment. The translator produces a 
straightforward translation that clearly indicates the parts of the translated program to be reviewed in light of the 
PDP-15's greater word length and more powerful instruction set. It does not simulate the PDP-8 or produce directly 
executable code. 

A full description is contained in PDP-15 8TRAN Manual (DEC-15-ENZA-D). 

1.3 BASIC I/O MOIMITOR 

The PDP-15/10 Basic I/O Monitor System simplifies the handling of input/output functions and facilitates the 
creation, debugging, and use of PDP-15/10 programs. It allows overlapped input/output and computation, as well as 
simultaneous operation of a number of asynchronous peripheral devices, while freeing the user from the need to 
create device handling subroutines. The Monitor, operating in conjunction with the Input/Output Programming 
System (lOPS), provides a complete interface between the user's programs and the peripheral hardware. 

The Monitor accepts I/O commands from the system or user programs and supervises their execution. By calling upon 
the device manipulation routines of lOPS, it provides for simultaneous I/O and computation. 

The Basic I/O Monitor contains: 

a. Routines for its own initialization and control 

b. Tables to allow communication between the Monitor, system programs, user programs, and the Input/Output 
Program System 

c. The CAL Handler, which is used to dispatch to the appropriate Monitor and I/O subroutines 

d. Device handlers for the teletype and clock. 

The Monitor resides in lower core and occupies about SSOj o locations. 
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1.3.1 Input/Output Programming System (lOPS) 

The Input/Output Programming System (lOPS) consists of an I/O control routine and individual hardware device 
handUng subroutines that process file and data level commands to the devices. These handlers exist for all standard 
PDP-1 5/10 peripherals (see Part II, Chapter 4). 

The I/O control routine accepts user program commands and transfers control to the appropriate device handlers. 
These device handlers are responsible for transferring data between the program and I/O devices, for initiating the 
reading or writing of files, for the opening and closing of files, and for the performance of all other functions peculiar 
to a given hardware device. They are also responsible for ignoring functions which they are incapable of handling (for 
example, trying to rewind a card reader, or skippmg files on a non-file-oriented device). All device handlers operate 
either with or without the Automatic Priority Interrupt (API) option. 

1.3.2 System Programs 

The Basic I/O Monitor, in addition to the lOPS, is complemented by the following system programs: 

a. FORTRAN IV Compiler, Object Time System, and Science Library 

b. MACRO- 15 Assembler 

c. FOCAL 

d. Dynamic Debugging Technique (DDT) Program 

e. Text Editor Program (EDITOR) 

f. Peripheral Interchange Program (PIP) 

g. Linking Loader (LOADER) 

h. 8TRAN, PDP-8 to PDP-15 Translator 
i. Chain Builder Program (CHAIN) 
j. Chain Execute Program (EXECUTE) 
k. PUNCH- 15 

1.3.2.1 FORTRAN IV Compiler - The PDP-15 FORTRAN IV compiler is a two-pass system that accepts statements 
written in the FORTRAN IV language and produces a relocatable object program capable of being loaded by the 
Linking Loader. It is completely compatible with USA FORTRAN IV, as defined in USA Standard X3.9-1966, with 
the exception of the following features, which were modified to allow the compiler to operate in 8192 words of core 
storage: 

a. Complex arithmetic is not legal. 

b. Adjustable array dimensions are not allowed at source level, but can be implemented by calling 
dime nsion-adj ustment subroutines. 
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c. Blank Common is treated as Named Common except when object program is used in chaining. 

d. The implied DO feature is not included for the DATA statement. 

e. Maximum of 5 characters in Hollerith constants. 

f. Specification statements must be strictly positioned and ordered. 

The FORTRAN IV compiler operates with the PDP-15/10 program interrupt or API facilities enabled. It generates 
programs that operate with the program interrupt or API enabled and can work in conjunction with assembly lan- 
guage programs that recognize and service real-time devices. Subroutines written in either FORTRAN IV or MACRO- 
15 assembly language can be loaded with and called by FORTRAN IV main programs. Comprehensive source lan- 
guage diagnostics are produced during compilation, and a symbol table is generated for use in on-hne debugging with 
DDT. 

The PDP-15 FORTRAN IV Compiler, Object Time System, and Science Library are described fully in the FORTRAN 
IV Manual (DEC-15-KFZA-D). 

1.3.2.2 FOCAL - The FOCAL (Formulating On-Line Calculations in Algebraic Language) compiler is an on-line 
interactive (conversational) system for non-programmers which makes use of standard mathematical notation and 
short imperative EngHsh command statements to solve user problems. 

Arithmetic capabilities of FOCAL permit single commands to generate random numbers and to evaluate standard 
functions including: square root, absolute value, sign, integer, and natural exponent of any number; sine, cosine, 
arctangent, and Naperian log value. 

With FOCAL, user defined mathematical operations are executed by a single command. In addition, specific 
hardware, text format, and error codes can be defined to facilitate user needs. 

The FOCAL compiler is described fully in the PDP-15 FOCAL Manual (DEC-15-KJZA-D). 

1.3.2.3 MACRO-IB - The MACRO-15 Assembler provides PDP-15/10 users with highly sophisticated macro 
generating and calling facilities within the context of a symbolic assembler. MACRO-15 is described in detail in the 
MACRO-15 Assembler Manual (DEC-15-AMZA-D), Some of the prominent features of MACRO-15 include: 

a. The ability to - 

(1) define macros 

(2) define macros within macros (nesting) 

(3) re-define macros (in or out of macro definitions) 

(4) call macros within macro definitions 

(5) have macros call themselves (recursion) 

b. Conditional assembly based on the computational results of symbols or expressions. 
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c. Repeat functions. 

d. Boolean manipulation. 

e. Optional octal and symbolic listings. 

f. Two forms of radix control (octal, decimal) and two text modes (ASCII and 6-bit trimmed ASCII). 

g. Global symbols for easy linking of separately assembled programs. 

h. Choice of output format: relocatable, absolute binary (check summed); or full binary capable of being loaded 
via the hardware READIN switch. 

i. Ability to call input/output system macros that expand into lOPS calling sequences. 

1.3.2.4 Dynamic Debugging Technique {DDT) Program - DDT provides on-line debugging facihties within the 
PDF- 15/ 10 Basic Software System, enabling the user to load and operate his program in a real-time envu-onment while 
maintaining strict control over the running of each section. DDT allows the operator to insert and delete breakpoints, 
examine and change registers, patch programs, and search for specific constants or word formats. 

The DDT- 15 breakpoint feature allows for the insertion and simultaneous use of up to four breakpoints, any one (or 
all) of which may be removed with a smgle keyboard command. The search facility allows the operator to specify a 
search through any part or all of an object program with a printout of the locations of all registers that are equal (or 
unequal) to a specified constant. This search feature also works for portions of words as modified by a mask. With 
DDT- 15, registers may be examined and modified in either instruction format or octal code, and addresses may be 
specified in symbohc relative, octal relative, or octal absolute. Patches may be inserted in either source language or 
octal. 

DDT-15 is described more fully in the PDP-15 Utility Program Manual (DEC-15-YWZA-D). 

1.3.2.5 Text Editor Program - The Text Editor of the PDP-15/10 Basic I/O Monitor provides the abiUty to read 
alphanumeric text from an input device (paper tape reader), to examine and correct it, and to write it on an output 
device. It can also be used to create new symbolic programs. 

The Editor operates on Hnes of symbohc text delimited by carriage return (CR) or ALT MODE characters. These lines 
can be read into a buffer, selectively examined, deleted or modified, and written out. New text may be substituted, 
inserted, or appended. 

For further details on the Text Editor, refer to the PDP-15 Utility Programs Manual (DEC-15-YWZA-D). 



1.3.2.6 Peripheral Interchange Program (PIP) - The primary function of PIP is to facilitate the manipulation and 
transfer of data files from any input device to any output device. It can be used to segment or combine files, perform 
code conversions, and copy tapes. 

Directions for the use of PIP- 15 can be found in the PDP-15 Utility Programs Manual (DEC-15-YWZA-D). 

1.3.2.7 Linking Loader - The Linking Loader loads any PDP-15, FORTRAN IV, or MACRO-15 object program 
which exists in relocatable format (or absolute format if pseudo-ops .ABS and .FULL are not used). Its tasks include 
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loading and relocation of programs, loading of called subroutines, retrieval and loading of implied subroutines, and 
building and relocation of the necessary symbol tables. Its operation is discussed in the PDP-15 Utility Program 
Manual (DEC-15-YWZA-D). 



1.3.2.8 8TRAN - 8TRAN is used to translate programs written in Pal III, PAL-D or MACRO-8 assembly language to 
MACRO- 15 assembly language for assembly and execution within the PDP-15 Basic Software environment. The 
Translator produces a straightforward translation that clearly indicates the parts of the translated program requiring 
review, in light of the PDP-15's greater word length and more powerful instruction set. It does not simulate the PDP-8 
or produce directly executable code. A full description is contained in PDP-15 - 8TRAN Manual (DEC-15-ENZA-D). 

1.3.2.9 Chain Builder and Execute Programs- The Chain Builder and Execute programs provide the user with a 
capability for program segmentation which allows for multiple core overlap of executable code and certain types of 
data areas. A more complete description of the Chain Builder and Execute programs is given in the Utility Programs 
Manual (DEC-15-YWZA-D). 

1.3.2.10 PUNCH-15 - PUNCH-15 is a utility program used to output selected areas of core memory onto paper tape 
for use with the PDP-15 Basic I/O Monitor. The primary applications of PUNCH-15 in the Basic I/O Monitor 
environment are: 

a. System program modification 

b. +.DAT SLOT reassignment 

c. Production of an executable user program core load on a single paper tape. This is particularly useful when 
that core load consists of a main program and several subroutines/library routines, the constant reloading of which 
may be time consuming. 

The PDP-15 Utility Programs Manual (DEC-15-YWZA-D) describes PUNCH-15 more fully. 
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PART II 

COMPACT SOFTWARE 









PART II 
COMPACT SOFTWARE 




CHAPTER 1 
COMPACT ASSEMBLER (CAP-15) 



1.1 INTRODUCTION 

The CAP-15 Assembler processes symbolic source programs to produce a binary code that can be executed by the 
PDP-15/10 computer. It normally processes source programs in two passes and requires 3K of core memory. The 
Assembler makes machine language programming for the PDP-15/10 easier, faster, and more efficient. It permits the 
programmer to use mnemonic symbols to represent instruction operation codes, locations, and numeric quantities; 
thus, the programmer can easily refer to any point in his program without knowing actual machine locations. 

The programmer can direct the Assembler's processing by means of a powerful set of pseudo-operation (pseudo-op) 
instructions. These pseudo-ops can be used for program control, to reserve blocks of core storage, to set the radix for 
numerical interpretation by the Assembler, to handle strings of text characters in 6-bit ASCII code, to define 
symbolic addresses, and many other functions that are described in detail in Section 1 .4. 

An output listing, showing both the programmer's source coding and the object program produced by the Assembler, 
can be printed. This listing includes all the symbols used by the programmer and their assigned values. If assembly 
errors are detected, erroneous lines are marked with meaningful letter codes, which can be interpreted by referring to 
Section 1.5.4. Operating procedures are found in Section 1.5. 

The Assembler normally processes a source program in two passes; that is, it reads the same source program twice, 
producing a printed listing and/or outputting the object code during the second pass, (However, if the listing and 
binary output utilize the same device, then a third pass is required to produce the binary output.) Assembler coding 
for the two passes is resident in memory at the same time. PASSl and PASS2 are almost identical in operation. The 
main function of PASSl is to identify locations that are to be assigned symbols, and to construct a symbol table. 
PASS2 uses the information derived by PASSl (and left in memory) to produce the final listing object code output. 



1.2 HARDWARE REQUIREMENTS AND OPTIONS 

The Assembler operates with PDP-15/10 systems having at least 4K of core memory and a console Teletype (ASR33). 
With the addition of a high-speed paper tape reader/punch; the user can significantly decrease assembly time and also 
have the capability of simultaneously producing a listing and binary output during PASS2. 
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1.3 ASSEMBLY LANGUAGE ELEMENTS 



1.3.1 Program Statements 

A single statement may be written on a 72-character teletype line, in which case a carriage return delimits the 
statement. Since a carriage return is not a printable character, it is represented in this manual as j 

STATEMENT^ 

Several statements may be written on a single line, separated by semicolons: 

STATEMENT ;STATEMENT;STATEMENT^ 

In this case, the statement line ends with a carriage return character, but semicolons are used as internal statement 
dehmiters. Thus, if a statement is followed by another statement on the same line, it must end with a semicolon. 

A statement may contain up to four fields separated by a space, spaces, or tab characters. These four fields are the 
label (or tag) field, the operation field, the address field, and the comments field. Because the space and tab characters 
are not printed, the space is represented by •— « , and the tab by -^ in this manual. Tabs are normally set ten spaces 
apart on most teletype machines, and are used to line the fields up in columns in the source program hsting. 

The basic statement format is as follows: 

LABEL H OPERATION H ADDRESS -^ /COMMENTS^ 

where each field is delimited by a tab or space, and each statement is terminated by a semicolon or carriage return. 
The comments field is preceded by a tab (or space) and a slash (/). 

An assembly statement may have an entry in any or all of the four fields. The following forms are acceptable: 

TAG^ 

TAG -*| OP^ 

OP H ADDR^ 
OP H ADDR i__j comments^ 
OP i_j comments^ 
^ ADDR^ 

-^ ADDR I I comments^ 

comments^ 

OP H ADDR^ 
OP H ADDR H comments^ 
OP H comments 
H ADDR^ 

H ADDR -^ commentsj 
/comments ^ 

-^ comments ^ 

Note that when a label field is not used, its delimiting tab is written, except for lines containing only comments. When 
the operation field is not used, its delimiting tab is written if an address field follows, except in label only and 
comments only statements. 



TAG - 

TAG 

TAG 

TAG 

TAG 

TAG 
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A label (or tag) is a symbolic address created by the programmer to identify the statement. When a label is processed 
by the Assembler, it is said to be defined. A label can be defined only once. The operation code field may contain a 
machine mnemonic instruction code, a pseudo-op code, a number, or a symbol. The address field may contain a 
symbol, number, or expression which is evaluated by the Assembler to form the address portion of a machine 
instruction. In some pseudo-operations, this field is used for other purposes, as explained later in this manual. 
Comments are usually short explanatory notes that the programmer adds to statement as an aid in analysis and 
debugging. Comments do not affect the object program or assembly processing; they are merely printed in the 
program Usting. Comments must be preceded by a slash (/); the slash must be preceded by one of the following: 



a. Space 

b. Tab 

c. Semicolon 

d. Carriage return 



1.3.2 Symbols 

A symbol consists of a string of alphabetic or alphanumeric characters (including periods and percent signs). The first 
character of a symbol must be a letter, a period or a percent sign. The first character of a symbol in the label field 
must not be a digit. A period can not be used alone as a symbol in the label field. The letter X, if used alone, can only 
appear in an address field (see 1.3.4.4). 



The following symbols are legal : 



MARK 1 


. . 1234 


.A 


A% 


%50.99 


.% 


P9.3 


INPUT 


.5A 



The following symbols are illegal: 



TAG:1 

5ABC 

X 



L@B1 



The colon (:) and @ are illegal characters. 
The first character may not be a digit. 
See section 1.3.4.4. 



Only the first six characters of a symbol are meaningful to the Assembler, but the programmer may use more for his 
own information. If he writes, 

SYMBOL 1 
SYMB0L2 
SYMB0L3 

as the symbolic labels on three different statements in his program, the Assembler will recognize only SYMBOL and 
type error flags on the lines containing SYMBOL 1, SYMB0L2 and SYMB0L3 because to the Assembler they are 
duplicates of SYMBOL. 



1.3.2.1 Evaluation of Symbols - When the Assembler encounters a symbol during processing of a source language 
statement, it evaluates the symbol by reference to two tables: The user's symbol table and the permanent symbol 



■3(Part II) 



table. The user's symbol table contains all symbols defined by the user. The user defines symbols by using them as 
labels or by direct assignment statements (see Section 1.3.2.2). A label is defined when first used, and cannot be 
redefined. When a label is defined by the user, it is given the current value of the Location Counter (see Section 
1.3.4). 

The Assembler has, in its permanent symbol table, definitions of the symbols for all of the PDP-15/10 memory 
reference instructions, operate instructions, index and limit register instructions, and some input/output transfer 
instructions. (See Appendix B for a complete Hst of these instructions.) Both the permanent symbol table and the 
user's symbol table reside in storage in alphanumeric sequence. The permanent symbol table symbols can be used in 
the operation field of a statement without prior definition by the user. 



Example 



-^ LAC uj A 



When the LAC symbol appears in the operation field of a statement, 
the Assembler treats it as an op code rather than a symbolic address. It 
has a value of 2000008, which is taken from the operation code 
definition in the permanent symbol table. 



The user can use instruction mnemonics (see Appendix B) or the pseudo-instruction mnemonics code (see Appendix 
C) as symbol labels. For example, 

DZM H DZM uj Y^ 

where the label DZM is entered in the user's symbol table and given the current value of the Location Counter, and 
the op code DZM is given the value 140000 from the permanent symbol table. The user must be careful, however, in 
his usage of these dual purpose (field dependent) symbols. Symbols in the operation field will be interpreted as either 
instruction codes or pseudo-ops, rather than as a symbolic label, if they are in the permanent symbol table. In the 
following example, several symbols with values have been entered in the user's symbol table and the permanent 
symbol table. The sample coding shows how the Assembler uses these tables to form object program storage words. 



User Symbol Table 


Permanent Symbol Table 


Symbol 


Value 


Symbol 


Value 


TAGl 

TAG2 

DAC 


100 
200 
300 


LAC 
DAC 
JMP 


200000 
040000 
600000 



If the following statements are written, 



the following code is generated by the Assembler 



TAGl H DAC H TAG2^ 



040200 



TAG2 H LAC H DAC^ 



200300 
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DAC H JMP H TAGl^ 600100 

HtAGIj 000100 



H H DACj 



000300 



1.3.2.2 Direct Assignment Statements — The programmer may define a symbol directly in the user's symbol table by 
means of a direct assignment statement, written in the form: 

SYMBOL = nj 

or 

SYMl =SYM2j 

where n is any number or expression. There should be no spaces before the symbol or between the symbol and the 
equal sign. (The operation field is assumed to be to the right of the equal sign, unless it is followed by a space or a tab, 
in which case the address field is assumed.) The Assembler enters the symbol in the user's symbol table, along with 
the assigned value. Symbols entered in this way can be redefined. The following are legal direct assignments: 

Z=28;A= 1;B = 2^ 

A symbol can also be assigned a symboUc value: 

A = 4j 
B = A^ 

The symbol B is given the value 4. Direct assignment statements do not generate storage words in the object pro- 
gram. In general, it is good programming practice to define symbols before using them in statements which gener- 
ate storage words. The Assembler will interpret the following sequence without trouble. 

Z-5^ 
Y= Z^ 
V = Y^ 

-^ LAC L-i V i_i /SAME AS LAC 5 

A symbol may be defined after use. For example, 

HLAC i-i Y^ 
Y=l^ 

This is called a forward reference, and is resolved properly in PASS 2. When first encountered in PASS 1, the LAC Y 
statement is incomplete because Y is not yet defined. Later in PASSl, Y is given the value 1. In PASS 2, the Assembler 
finds that Y = 1 in the symbol table, and forms the complete storage word. 



l-5(Part II) 



Since the Assembler operates in two passes, only one-step forward references are allowed. The following forward 
reference is illegal: 

-^LAC l-jY^ 

In the listing, during PASS 1 , the line which contains Y = Z will be printed with an A error code indicating a direct 
assignment error. 



1.3.2.3 Undefined Symbols - If any symbols remain undefined at the end of PASSl of assembly, they are 
automatically defined as the addresses of successive registers following the end of the program (i.e., following the 
highest program counter value encountered by the Assembler). All statements that referenced the undefined symbol 
will be flagged as undefined. One memory location is reserved for each undefined symbol with the initial contents of 
the reserved location being unspecified. 

Example 



Location 
Counter 


Source Statement 


Generated 
Code 


Comments 


100 


Hlacundefi^ 


200104 


-> 




101 


-^ LAC UNDEF3 


200106 






102 


H LAC UNDEF4 


200107 




^ Flagged as an error 


103 


-^ LAC UNDEF2 
H.END 


200105 


J 





1.3.3 Numbers 



L3.3.1 Integer Values - An integer is a string of digits, with or without a leading sign. Negative numbers are 
represented internally in two's complement form. The range of integers is as follows. 



Unsigned 
Signed 



0^262143io 
0^ 131071io 



{111771s) 
(3777778) 



e.g.,2i«-l 
e.g., ±21^-1 



An octal integer* is a string of digits (0-7), signed or unsigned. If a non-octal digit is encountered (8 or 9) it will be 
flagged as a numerical error. 



^Initiated by usage of .OCT pseudo-instruction and is also the initial assumption if no radix control pseudo-instruction was encountered (see 
Section 1.4.4). 
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Example 



Coded Value 


Generated Value (Octal) 


Comment 


-5 


777773 


two's complement 


3347 


003347 




3779 


000000 


error 



A decimal integer* is a string of digits (0-9), signed or unsigned. 
Example 



Coded Value 


Generated Value (Octal) 


Comment 


-8 
256 


777770 
000400 


two's complement 



1,3.3.2 Expressions — Expressions are strings of symbols and numbers separated by arithmetic or Boolean operators. 
Expressions represent unsigned numeric values ranging from to 2^^ -1. All arithmetic is performed in unsigned 
integer arithmetic (two's complement), modulo 2^ ^ . Division by zero is regarded as division by one and results in the 
original dividend; this condition will not be regarded as an error. Fractional remainders are ignored. The value of an 
expression is calculated by substituting the numeric value for each element (symbol) of the expression and performing 
the specified operations. 

The following are allowable operators to be used with expressions: 



Character 


Function 


Name 


Symbol 


Plus 






+ 


Addition (two's complement) 


Minus 






- 


Subtraction (convert to two's complement 
and add) 


Asterisk 






* 


Multiplication (unsigned) 


Slash 






/ 


Division (unsigned) 



*Initiated by usage of .DEC pseudo-op (see Section 1 .4.4). 
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Character 






Name 


Symbol 




Function 


Ampersand 




& 


Logical AND 




Exclamation point 




1 


Inclusive OR 


Boolean 


Back slash 




\ 


Exclusive OR J 




Comma 




) 







Operations are performed from left to right (i.e., in the order in which they are encountered). For example, the 
assembly language statement A + B*C + D/E - F * G is equivalent to the following algebraic expression 



(((((A + B)* C) + D)/E) - F)* G. 



Example 



Assume the following symbol values: 



Symbol 


Value (Octal) 


A 


000002 


B 


000010 


C 


000003 


D 


000005 



The following expressions would be evaluated according to the rules above. 



Expression 


Evaluation (Octal) 


A+B-C 


000007 


A/B+A * C 


000006 


B/A-2*A-i 


000003 


A&B 


000000 


C+A&D 


000005 


B*D/A 


000024 


B*C/A*D 


000074 



(The remainder of A/B is lost) 
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The expression (A + B) * (C + D) cannot be represented in one source statement. To circumvent this problem, at least 
one of the members of the expression should be defined by a direct assignment statement (see Section 1.3.2.2). 

Examples 

E = A + B J 

C + D *E /Represents (A + B) * (C + D)\ 

or 

E = A + B J 

F = C + D^ 

E * F /Represents (A + B) * (C + DU 

1 .3.4 Address Assignments 

As source program statements are processed, the Assembler assigns consecutive memory locations to the storage 
words of the object program. This is done by reference to the Location Counter, which is initially set to zero, and 
incremented by one each time a storage word is formed in the object program. Some statements, such as machine 
instructions, cause only one storage word to be generated, incrementing the Location Counter by one. Other 
statements, such as those used to enter data or text, or to reserve blocks of storage words, cause the Location Counter 
to be incremented by the number of storage words generated. 

1.3.4.1 Referencing the Location Counter - The programmer may directly reference the Location Counter by using 
the period symbol {.) in the address field. He can write 

H JMP ,_, . -IJ 

which will cause the program to jump to the storage word the address of which was previously assigned by the 
Location Counter. The Location Counter can be set to another value by using the .LOC pseudo-op, as described in 
1,4.8. 



1.3.4.2 Direct Addressing - Direct Addressing occurs when bits 4 and 5 of the Memory Reference Instruction word 
(see Figure 1-1) are set to 0. The machine action defined by the operation code field is applied to the operand 
specified by the 12-bit address field. The 12-bit address field allows addressing of any location of the 4,096 word 
memory page. Access to locations outside the current page is gained via execution of indexed or indirect address 
instructions. 



1.3.4.3 Indirect Addressing - To specify an indirect address, which can be used only in memory reference 
instructions, the programmer writes an asterisk (*) immediately following the operation field symbol. This sets the 
Defer Bit (bit 4) for the storage word (see Figure 1-1) and the contents of the address field point to a location (within 
the current page) which contains the 1 5-bit effective address. 

The error flag S results if an asterisk (*) suffixes a non-memory reference instruction. 
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Two examples of legal indirect addressing are as follows: 

H TAD* H A^ 
H LAC* H B^ 



The following example is illegal. 

H CLA*^ 



Indirect addressing cannot be specified in non-memory reference 
instructions. 



NOTE 



A symbol followed by an asterisk and by another symbol is interpreted as a 
multiplication operation (e.g., LAC* SYMBOL). 



17 



Operation 
Code 


* 


X 


Address Field 



X= Indexed Address Indicator 
*= Indirect Address Indicator 



Figure 1-1. Memory Reference Instruction Format 



1.3.4.4 Indexed Addressing - Indexed Addressing is specified by bit 5 (indirect bit) of the Memory Reference 
Instruction word (see Figure 1-1) being set to 1. Indexed Addressing can be either Direct or Indirect. For Direct 
Indexed Addressing, bit 4 is and bit 5 is 1. In this mode, the effective address is taken as the sum of the 12-bit 
address field (bits 6-17) and the contents of the Index Register. The Index Register is an 18-bit hardware register 
which may contain a signed 2's complement number. 

Indirect Indexed Addressing is specified by bits 4 and 5 being set to 1. In this mode of addressing, the effective 
address (EFA) is taken as the contents of the location specified by the sum of the 1 2-bit address field and the Index 
Register. 
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Example 

LAC* H 30,X 

/C(30) + C(XREG) = EFA 
Contents /37 + 20 = EFA 

C(30) = 37 /57 = EFA 

C(XREG) = 20 /C(57) = AC 

C(57)=101 /101 = AC 

Using a comma X(,X) in the address field causes bit 5 of the current address value to be exclusively ORed with 10000. 
For example, if bit 5 of the previous address value was 1, this operation sets it to 0. The Assembler takes this into 
consideration when the operation field value and the address field value are combined (see 1.3.6.2). 

In all cases when X is used, the value 10000 is used to perform the operation specified.* Standard usage of X is shown 
below. 

Example 

A =50 

LAC -4A,X 

Storage word generated 210050 

Using X to denote Index Register usage causes the following restrictions: 

a. X cannot be used as a TAG. 

b. X may not be used more than once in an expression. 

c. X can only appear in an address field. 

d. X cannot be used with a .DSA statement. 



1.3.4.5 Literals — Symbolic data references in the operation and address fields may be replaced with direct represen- 
tation of the data enclosed in parentheses**. This inserted data is called a literal. The Assembler sets up the address 
link, therefore one less statement is necessary in the source program. 

The following examples show how literals may be used, and their equivalent statements. The information contained 
within the parentheses, whether a number, symbol, expression, or machine instruction, is assembled and assigned 
consecutive memory locations after the highest location used by the program (including registers reserved for 
undefined symbols). The address of the generated word will appear in the statement that referenced the literal. 
Duplicate literals are stored only once so that many uses of the same literal in a given program result in only one 
memory location being allocated for that Hteral. Nested literals are not allowed and result in an L error diagnostic at 
assembly time. 



*The symbol X should only be used for indexing purposes. After the expression has been evaluated, bit 5 will be set to 1 regardless of 
the expression result. 
**The opening parenthesis [ ( ] is mandatory while the closing parenthesis [ ) ] is optional. The operation field is assumed to be to the 
right of the opening parenthesis [ ( ] unless it is followed by a space or tab, in which case the address field is assumed. 
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Usage of Literal 


Equivalent Statements 


-^ ADD uj (1) 




H ADD i-j ONE 




ONE 


Hi 


-^ LAC i_i (TAG 




H LAC i_. TAGAD 




TAGAD 


Htag 


H LAC ,_, (DAC H TAG) 




H LAC uj INST 




INST 


H DAC H TAG 


-*1 LAC u-i (JMP -^ .+2) 


HERE 


H LAC u-j INST 




INST 


H JMP i_i HERE+2 



The following sample program illustrates how the Assembler handles literals. 



Location Counter 


Source Statement 


Generated Code 




-^ XOC uj 100 




100 


TAGl H LAC ,_j (100) 


200110 


101 


H DAC i_i 100 


040100 


102 


H LAC i_, (JMP ,_, .+5) 


200111 


103 


H LAC L-j (TAG!) 


200110 


104 


H LAC t-j (JMP u-i TAGl) 


200112 


105 


-4 LAC ,_, (JMP u-i TAG2) 
TAG2=TAG1 


200112 


106 


H LAC ,_i (JMP) 


200113 


107 


DAC H LAC L_i (DAC ^ DAC) 
H .END 


200114 
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Location 
Counter 


Source Statement 


Generated 
Code 


Generated Literals 


110 




000100 


111 




600107 


112 




600100 


113 




600000 


114 




040107 



1.3.5 Statement Fields 

1.3.5.1 Label Field - If the user wishes to assign a symbolic label to a statement, to facilitate references to the 
storage word generated by the Assembler, he may do so by beginning the source statement with any desired symbol. 
The symbol must be terminated by a space (spaces) or tab, or a statement terminating semicolon, or carriage return. 



Examples 



TAG t-j any valuej 
TAG u-j any value ^ 
TAG -*| any value \ 
TAG; 
TAG^ 



These examples are equivalent to coding 

TAG H 0^ 

in that a word of all Os will be output with 
the symbol TAG associated with it. 



Symbols used as labels are defined in the user's symbol table with a numerical value equal to the present value of the 
Location Counter. A label is defined only once; if it was previously defined by the user, the current definition of the 
symbol will be flagged as a multiple definition error. All references to a multiply-defined symbol will be made to the 
first value encountered by the Assembler. 

Example 



Location 
Counter 


Statement 


Storage Word 
Generated 


Notes 


100 
101 
102 


A H LAC H B 
A H LAC He 

Hlac Ha 


200103 
200104 
200100 


error, multiple definition 
first value of A referenced 
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Location 
Counter 


Statement 


Storage Word 
Generated 


Notes 


103 
104 


B H 

c H 


000000 
000000 





Anything more than a single symbol to the left of the label-field dehmiter is an error; it will be flagged and ignored. 
The following statements are illegal. 



TAG+1 
LOG* 2 



H LAS^ 
H RAR) 



Redefinition of certain symbols can be accomplished by using direct assignments; that is, the value of a symbol can be 
modified. If an Assembler permanent symbol or user symbol (which was defined by a direct assignment) is redefined, 
the value of the symbol can be changed without causing an error message. If a user symbol, which was first defined as 
a label, is redefined by either a direct assignment or by using it again in the label field, it will cause an error. 

Example 



Coding 



Generated Value (Octal) 



Comments 



A=3 

H LAC -^ A 
H DAC -*| A 



200003 
040003 



sets current value of A to 3 



A=4 






redefines value of A to 4 


H LAC 


HA 


200004 




* B HdAC 


HA 


040004 




B=A 






illegal usage; a label cannot be 
redefined 


^DAC 


Hb 


040105 




PSF=700201 






to redefine possibly incorrect 








permanent symbol definition. 



*Assume that this instruction wiU occupy location 105. 

1.3.5.2 Operation Field - Whether or not a symbol label is associated with the statement, the operation field must be 
delimited on its left by a space(s) or tab. If it is not delimited on its left, it will be interpreted as the label field. The 
operation field may contain any symbol, number, or expression which will be evaluated as an 18-bit quantity using 
unsigned arithmetic modulo 2^^. In the operation field, machine instruction op-codes and pseudo-op mnemonic 
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symbols take precedence over identically named user defined symbols. The operation field must be terminated by one 
of the following characters: 

-*| or I— I (s) field delimiters 



or 



statement delimiters 



Examples 



TAG H ISZ^ 

H .+3 U-. ^ 
uj CMA!CMLJ 
H TAG/5+TAG2: 



H TAG3 



1.3.5.3 Address Field - The address field, if used in a statement, must be separated from the operation field by a tab, 
or space(s). The address field may contain any symbol, number, or expression which will be evaluated as an 18-bit 
quantity using unsigned arithmetic, modulo 2^^. If op-code or pseudo-op code symbols are used in the address field, 
they must be user defined, otherwise they will be undefined to the Assembler and cause an error message. The symbol 
X cannot be user defined (see section 1.3.4.4). The address field must be terminated by one of the following 
characters: 



-^ or i_j (s) 



or ; 



field dehmiters 



statement delimiters 



Examples 



TAG2 H DAC -i^ .+3 -^ /COMMENT^ 

^ H TAG2/5 + 3 i_i (s)^ 

H ISZ H TAG2, X + 4^ 

H JMP H BEGIN^ 

H TAD -^ A; H DAC ^ B^ 

In the last example, a tab or space(s) is required after the semicolon so the Assembler can interpret DAC as being the 
operation field rather than the label field. 

An error condition will exist if the bank and page bits (3, 4 & 5) of the address do not match the bank and page bits 
of the bank currently being assembled into and the extended memory bits of the address are not zero. 

Examples 



Location 
(octal) 


Instruction 


Comments 


1000 
1001 


HLAC ^ 100 

Hdac ,_i loi 


will not cause error messages 
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Location 
(octal) 


Instruction 


Comments 


1002 


H JMS i_j 250 


will not cause error messages 


1003 


HiSZ i_, 40146 


will cause a bank error message code B 
(see 1.3.5.3) 


1004 


H LAC u-i 10100 


will cause a bank error message code 
(see 1.3.5.3) 



1.3.5.4 Comments Field — Comments may appear anywhere in a statement. They must begin with a slash (/) 
immediately preceded by a 

i_j (s) space(s) 

H tab 

J carriage return (end of previous line) 

; semicolon 

Comments are terminated only by a carriage return. 

Examples 

i_i (s)/ THIS IS A COMMENT^ 

TAGl -^ LAC i_i /after the ; is still a comment^ 

/THIS IS A COMMENT^ 

H RTR i_i /COMMENT^ 

H RTR; H RTR; /THIS IS A COMMENT^ 

Observe that -*\ A/COMMENT^ is not a comment, but rather an operation field expression. A line that is 
completely blank; that is, there is no data between two sets of^ (s), will be treated as a comment by the Assembler. 

1.3.6 Statement Evaluation 

When the Assembler evaluates a statement, it examines the first character position in the label, operation, and address 
fields for a numeric character. (Comments fields are ignored.) If the first character of a field is numeric, the contents 
of the whole field is treated as a number. 

1.3.6.1 Numbers - Numbers are not field dependent. When the Assembler encounters a number (or expression) in 
the operation or address fields (a number in the first character position of the label field is illegal), it uses those values 
to form the storage word. The following statements are equivalent: 
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H 200000 ,_i IQJ 

HlO + LAC^ 

H LAC i_i 10^ 
All three statements cause the Assembler to generate a storage word containing 200010. 
A statement can consist of a number or expression which generates a single 18-bit storage word; for example, 

H 23; i_j 45; i_j 357; l«i 62 J 
This group of four statements generates four words interpreted under the current radix. 
Zero words are generated by statements containing only labels. For example, 

A;B;C;D;EJ 
generates five words set to zero, which can be referenced by the labels defined. 



1.3.6.2 Word Evaluation — When the Assembler encounters a symbol in a statement field, it determines the value of 
the symbol by referring to the user's symbol table and the permanent symbol table, according to the priority Hst 
shown below. The value of a storage word is computed by combining the 18-bit operation field quantity with the 
18-bit address field quantity, in the following manner. 

[(OPERATION FIELD + (ADDRESS FIELD & 017777))] = Value of Word 
0-17 0-17 

If the operation code is one of the 9-bit operators (see Appendix B), the word value is computed as follows. 

[(OPERATION FIELD + (ADDRESS FIELD & 777))]= Value of Word 
0-17 0-17 



Extensive error checking is performed on the address field value to ensure correct results. If the page bit of the 
address field is different from that of the program counter, the line is flagged with a 'B' error code at assembly time, 
indicating a page error. Page bits are always set to if the address value is legal and Index Register usage is not 
specified. 



Example. 



Error 
Flag 



LOG 



00100 



Object 
Code 



210000 



Source Code 

.LOC 100 

LAC B /ADDRESS OF B ON A DIFFERENT PAGE 



B 



10000 



040100 



B 



.LOC 10000 

DAC A /ADDRESS OF A ON A DIFFERENT PAGE 



The LAW instruction and the 9-bit operators check the low order 5 bits (or 9 bits) of the address value for validity by 
ANDing off the low order bits and checking the result for or for equality with the 'AND' value. 
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[address field & 760000] = 760000 or 000000 

OR 

IF A 9 BIT OPERATOR 

[address field & 777000] = 777000 or 000000 



Example 



LAW -1 /The value for -1 is 111111. 

/When this value is ANDed 
/with 760000, the result 
/is 760000 and valid. 

If the ADDRESS FIELD and 7600008 does not equal 7600008 or 000000, any erroneous results produced are 
flagged by the Assembler. This validity check is performed only if an operation field and an address field are present. 

If the ADDRESS FIELD ANDed with 7600008 does not equal 7600008 or 000000, any erroneous results produced 
are flagged by the Assembler. This validity check is performed only if an operation field and an address field are 
present. 

If the instruction is a Memory Reference instruction, the low order 5 bits of the address value are examined to make 
sure they are not set*. If any of the 5 bits are set, the line is flagged with an E error code during assembly. 

^ 2 ^ 5 -^ /GENERATES 000007 

The value of a symbol depends on whether it is in the label field, or the address field. The Assembler attempts to 
evaluate each symbol by running down a priority list, depending on its field as shown. 



Label Field 

Current value of 
Location Counter 



Operation Field 

1. Pseudo-op 

2. Direct assignment in user 
symbol table. 

3. Permanent symbol table 

4. User symbol table 

5. Undefined 



Address Field 

1. User symbol table, 
( i n eluding direct 
assignments) 

2. Undefined 



This means that if a symbol is used in the address field, it must be defined in the user's symbol table; otherwise, it is 
undefined. 

In the operation field, pseudo-ops take precedence and cannot be redefined. Direct assignments allow the user to 
redefine machine op codes, as shown in the example below. 



*Does not include LAW instruction. 
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Example 

DPOSIT = DAC^ 

The user can use machine instruction codes and Assembler pseudo-op codes in the label field and refer to them later 
in the address field. 

1.4 PSEUDO OPERATIONS 

In the discussion of symbols in the previous chapter, it was stated that the Assembler has, in its permanent symbol 
table, definitions of the symbols for all the PDP-15 memory reference instructions, operate instructions, and some 
lOT instructions (hsted in Appendix B) which may be used in the operation field without prior definition by the user. 
Also contained in the permanent symbol table are a class of symbols called pseudo-operations (pseudo-ops) which, 
instead of generating instructions or data, direct the assembler on how to proceed with the assembly. 

By convention, the first character of every pseudo-op symbol is a period (.)- This convention is used to prevent the 
programmer from inadvertently using, in the operation field, a pseudo-instruction symbol as one of his own. 
Pseudo-ops may be used only in the operation field. 

lAl Program Control (.END) 

One pseudo-op that must be included in every source program is .END, which must be the last statement in the 
program. This statement marks the physical end of the source program and may also contain the location of the first 
instruction in the object program to be executed at run-time. 

The .END statement is written in the general form 
H .END L-j START^ 

where START may be a symbol, number, or expression whose value is the address of the first program instruction to 
be executed - 

If a starting address is not present in an .END statement, the program will halt after being loaded and the user must 
manually start his program. 

The following are legal .END statements: 

-4 END i_i BEGIN + 5^ 

^ .END L_i 200^ 

H END; 

1.4.2 Program Segments (.EOT) 

If the input source program is physically segmented, each segment except the last must terminate with an .EOT 
(end-of-tape) statement. The last segment must terminate with an .END statement. For example, if the input source 
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program is prepared on three different tapes, the first two are terminated by .EOT statements, and the last by an 
.END statement. The .EOT statement is written without label and address field, as follows. 

H -EOT^ 

1 .4.3 Reserving Storage Words In The Object Program 

The programmer may reserve blocks of storage words, or single words, for use during program execution. 

1.4.3.1 Reserving Blocks of Storage (.BLOCK) - .BLOCK reserves a block of memory equal to the value of the 
expression contained in the address field. If the address field contains a numerical value, it will be evaluated according 
to the radix in effect. The symbohc elements of the expression must have been defined previously; otherwise, phase 
errors (see Section 1.5.5) might occur in PASS2. 

The user may reference the first location in the block of reserved memory by defining a symbol in the label field. The 
initial contents of the reserved locations are unspecified. 



Label Field 


Operation Field 


Address Field 


User Symbol 


.BLOCK 


Predefined Expression 



Examples 

BUFF H. BLOCK uj 12 

^ .BLOCK u A-B+65^ 

\A3.2 Reserving Single Storage Words - Storage words set to zero are set up as 

A HO; HO; HOJ 

In this way, three words are set to zero, starting at A. Storage words set to zero are also set up by statements 
containing only labels: 

A;B;C;D;EJ 

1.4.4 Radix Control (.OCT and .DEC) 

The initial radix (base) used in all number interpretation by the Assembler is octal (base 8). In order to allow the user 
to express decimal values, and then restore to octal values, two radix setting pseudo-ops are provided. 



Pseudo-op Code 


Meaning 


.OCT 

.DEC 


Interpret all succeeding numerical values in base 8 (octal) 
Interpret all succeeding numerical values in base 10 (decimal) 
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These pseudo-instructions must be coded in the operation field of a statement. All numbers are decoded in the 
current radix until a new radix control pseudo-instruction is encountered. The programmer may change the radix at 
any point in a program. 



Source Program 


Generated Value (Octal) 


Radix in Effect 


H LAC 

H25 


H 100 


200100 
000025 


8 

initial value is 
assumed to be octal 


-4 .DEC 








Hlac 


H 100 


200144 


10 


^ 275 




000423 


10 


^ .OCT 








H76 




000076 


8 


H 85 




000000 


error 



1.4.5 Text Handling (.SIXBT) 



Label Field 


Operation Field 


Address Field 


SYMBOL 


.SIXBT 


delimiter 


character string 


delimiter 



.SIXBT denotes 6-bit trimmed ASCII characters, which are formed by truncating the leftmost bit of the 
corresponding 7-bit ASCII character. The Assembler converts the characters to their appropriate numerical equivalent 
(see Appendix A). The characters are packed, three per word left justified, with unused bits set to zero. 



5 


6 11 


12 17 


1st character 


2nd character 


3rd character 



Spaces or tabs prior to the text dehmiter are ignored. Any printing character may be used as the text delimiter, 
except ^ . The text delimiter must be present on both ends of the text string, otherwise, the user may get more 
characters than desired; however,^ may be used to terminate the test string. After a carriage return, a new .SIXBT 
pseudo-op is necessary to continue with 6-bit text. 
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Examples 



Source 


Generated Code 


-^.SIXBT -^/ABCDE/^ 


010203 




040500 


TAG ^.SIXBT H-/125/-J 


576162 




655700 


H-SIXBT H/ABCD^ 


010203 




040000 



1 ,4.6 Defining A Symbolic Address (.DSA) 

.DSA (define symbol address) is used in the operation field when it is desired to create a word composed only of an 
address field. It is especially useful when a user symbol is also an instruction or pseudo-op symbol. 



Label Field 


Operation Field 


Address Field 


User Symbol 


.DSA 


Any expression 



Examples 



JMP H LAC H TAG 
H .DSA H JMP 

H H JMP 



Equivalent methods of defining the user symbol JMP to be in the 
address field. 



L4.7 Conditional Assembly {.IFDEF, . I FUND and .ENDC) 

It is often useful to assemble some parts of the source program on an optional basis. This is done by means of 
conditional assembly statements of the form; 



H.iF... H 



expression 



The pseudo-op may be one of the two conditional pseudo-ops shown below, and the address field may contain any 
symbol or expression. If the condition is satisfied, that part of the source program starting with the statement 
immediately following the conditional statement and up to the .ENDC (end conditional) pseudo-op is assembled. If 
the condition is not satisfied, this coding is not assembled (it is treated as comments). 

The two conditional pseudo-ops (sometimes called IF statements) and their meanings are shown below. 



Conditional 
Pseudo-op 



IFDEF X 
IFUND X 



Assemble 
IF X is: 



defined (present) in user symbol table 
undefined (not present) in user's symbol table 



l-22(PartII) 



In the following sequence, the pseudo-op JFDEF is satisfied, and the source program coding between .IFDEF and 
ENDC is assembled. 

H .IFDEF H Y^ 

H LAC L-i A^ 

H DAC ,_, B^ 

^ .ENDC^ 

Conditional statements may be nested. For each IF statement there must be a terminating .ENDC statement. If the 
outermost IF statement is not satisfied, the entire group is not assembled. If the first IF is satisfied, the succeeding 
coding is assembled. If another IF is encountered, however, its condition is tested, and the succeeding coding is 
assembled only if the second IF statement is satisfied. Logically, nested IF statements are like AND circuits. If the 
first, second and third conditions are satisifed, then the coding that follows the third nested IF statement is 
assembled. 



Example 



"H IFDEF ._. W^ 
H LAC H TAG^ 
H IFUND uj Y^ 
H DAC H TAGl^ 
H ENDCJ 
-^ IFDEF u_, ZJ 
H DAC H TAG2^ 
H ENDC^ 
H .ENDC^ 



conditional 1 initiator 

conditional 2 initiator 

conditional 2 terminator 
conditional 3 initiator 

conditional 3 terminator 
conditional 1 terminator 



IF statements may be activated by means of a strip of tape which precedes the regular source tapes. The strip tape 
may take on the following form: 



Strip Tape 

A = 
B-0 
H .EOT 



/Causes A and B to be 

/entered into the user's symbol table. 

/Terminates the strip tape 
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Source Program 

H-IFDEF -*|A 



/This coding would be assembled. 



-^ .ENDC 

H .IFUND H B 



/This coding would not be assembled. 



H .ENDC 

H .END 

Since the purpose of the strip tape is to enter definitions into the user's symbol table, it is only necessary to have the 
strip tape read in PASSl of assembly. 

1.4.8 Setting The Location Counter (.LOG) 



Label Field 


Operation Field 


Address Field 


Not Used 


.LOC 


Predefined symbolic 
expression, or number 



The .LOC pseudo-op sets or resets the Location Counter to the value of the expression contained in the address field. 
The symbolic elements of the expression must have been defined previously; otherwise, phase errors might occur in 
PASS2. The .LOC pseudo-op may be used anywhere and as many times as required. If the .LOC pseudo-op is not 
used, the assembler assumes location as the starting point of the program. 

Examples 



Location Counter 


Instruction 


100 
100 


H .LOC i_i 100 
H LAC i_, TAGl 
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Location Counter 


Instruction 


101 


H DAC i_i TAG2 


102 


H LOG i_i 


102 


A ^ LAC t-i B 


103 


HDAC L-i C 


107 


H .LOG ,_. A+5 


107 


H LAG ,__j C 


110 


^ DAC i-J D 


111 


^ LAC i_i E 


112 


-*\ DAC i_j F 



1.4.9 Listing Control (.XLIST and .LIST) 

The following assembler listing controls are effective only when a listing was requested in the command string 
(Section 1.5.2). 

The .XLIST statement causes the assembler to stop listing the assembled program. The listing printout actually starts 
at the beginning of PASS2; therefore, to suppress all of the program listing, .XLIST must be the first statement in the 
program. If only a part of the program Hsting is to be suppressed, the .XLIST statement can be inserted at any point 
to stop Usting from that point. 

The .LIST statement, which is normally used following an .XLIST statement, causes the assembler to resume the 
listing at the point at which it is encountered. 



1.4.10 Object Output Control (.FULL) 



Label Field 


Operation Field 


Address Field 


Not Used 


.FULL 


Not Used 



The .FULL pseudo-op causes hardware readin-mode binary output to be produced (see Section 1.5.4.3 for a 
description of the normal binary output). It must appear before any coding (except comments), otherwise, it will be 
flagged and ignored. The program is assembled as unchecksummed binary code and each physical record of output 
contains nothing other than 1 8-bit binary storage words generated by the Assembler. The Assembler will cause the 
address of the .END statement to contain a punch in channel 7, thereby allowing the output to be loaded via 
hardware readin mode. If no address is specified in the .END statement, a halt (rather than a jump) will be output as 
the last word. 
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The following specific restrictions apply to programs assembled in .FULL mode output 

•LOG Should be used only at the beginning of the program, 



BLOCK 



May be used only if no literals appear in the program, and must 
immediately precede .END. 

Undefined symbols may be used if no hterals appear in the program. 

Literals may be used only if the program has no undefined symbols. 



1.4.1 1 Size of Program (.SIZE) 

When the Assembler encounters .SIZE, it outputs, at that point, the address of the last location plus one occupied by 
the object programs. This is normally the length of the object program (in octal). 



Label Field 


Operation Field 


Address Field 


User Symbol 


.SIZE 


Not Used 



Example 



Generated Code 


Source Code 


00100 




00100 


000105 


00101 


200103 


00102 


040104 


00103 


000000 


00104 


000000 




000000 



-H.Loc Hioo^ 

^ .SIZE^ 

Hlac Ha^ 
Hdac Hb^ 

A Hoj 

B Ho^ 

H .END^ 



1.5 OPERATING PROCEDURES 



1.5.1 Loading Procedures 



The loading procedure depends on whether the Teletype paper tape reader or the high-speed paper tape reader is used 
as the loading device. 
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1.5.1.1 Teletype Reader as Loading Device — Place paper tape of the hardware readin low-speed binary loader (see 
Appendix D) into the teletype reader. Engage the start switch on the reader. Enter 7700 into the ADDRESS switches 
(17700 if computer has 8K of memory). Press I/O RESET and then press READIN. When the computer halts 
(AC=777777), disengage the start switch, place the Assembler binary tape into keyboard reader, engage the start 
switch, and press START. 

1.5.1.2 High-Speed Reader as Loading Device — Place paper tape of the Hardware Readin High-speed Binary Loader 
(see Appendix D) into the high-speed reader. Enter 7720 into the ADDRESS switches (17720 if computer has 8K of 
memory). Press I/O RESET and then press READIN, When computer halts (AC = 777777) place the Assembler 
binary tape into high-speed reader and press START. 



1.5.2 COMMAND String 

After the Assembler has been loaded into memory, it will type out a sequence of messages. The user's responses to 
these messages indicate the options and devices that are to be used for the current assembly, 

1.5.2.1 Binary Option - The first message typed is *BIN -. If no binary output is desired, the user responds with 
carriage return (^ ). 

If binary output is desired, the user types L^ if the binary device is the low-speed punch, or H^ if the binary device 
is the high-speed punch. If any other character is typed it is ignored and the message (*BIN -) is repeated.* 

1.5.2.2 Listing Option - The second message typed is *LST-. If no listing is desired, the user responds with ^ . If a 
hsting is desired, the user types L^ to produce the Usting on the teleprinter, or H^to produce the listing on the 
high-speed punch. If any other character is typed, it is ignored and the message (*LST-) is repeated.* 



1.5.2.3 Symbol Table Option - The third message typed is *SMB-. If no symbol table output is desired, the user 
responds with^ . If symbol table output is desired, the user types L^ to produce the symbol table on the teleprinter, 
or types H^ to produce the symbol table on the high-speed punch. If any other character is typed it is ignored and 
the message (*SMB-) is repeated.* 

1.5.2.4 Source Input Device - The last message typed is *SRC-. If the source program is to be read from the 
keyboard reader, the user types L ^ . If it is to be read from the high-speed reader, the user responds with H^ . If H 
or L is not specified, or if any other character is typed, it is ignored and the message (*SRC-) is repeated.* When the 
carriage return is typed, the Assembler starts reading from the input device. 

1.5.2.5 Error Printout — Normally, all errors that are encountered by the Assembler are output to the listing device 
and to the Teletype, if it is not the Hsting device. If no error printout is desired on the Teletype, it can be suppressed 
by typing N in addition to the normally typed character on any of the four command string messages prior to typing 
the carriage return. 



''Note, that the character just prior to the carriage return (J) is the one accepted by the Assembler, and therefore, if it is desired to 
change it, it may be retyped before the ^ is typed. 



■27(Part II) 



Examples 

(All characters underlined are typed by the Assembler) 

BIN - H^ Binary on high-speed punch. 

*LST - N^ No hsting, and suppress error printout on Teletype. 



'SMB - L^ Symbol printed on Teletype. 



SRC - Hy Source input from high-speed reader. 



*BIN - F^ Illegal request, message repeated. 



'BIN - hj Binary output on Teletype punch. 



*LST - L^ Listing on Teletype. 



=SMB - h) Symbol table printout on Teletype. 



*SRC - L^ Source input from keyboard reader. 



NOTE 

Normally, the Assembler requires two passes to assemble any program: 
however, if the binary output device and the listing device are the same 
device, then three passes are required. PASS2 produces the hsting and PASS3 
produces the binary object code. PASS2 always produces the symbol table, 
if requested. When assembly is completed, the Assembler returns to the 
command string processor for additional assemblies. 

1.5.3 Continuation and Termination Control 

Two control characters are available to control Assembler processing: CTRL C and CTRL P. They are typed by 
holding the CTRL key and striking either C or P. The Assembler echoes these characters as tC or tP. 

CTRL C may be typed when it is desired to prematurely terminate assembly and return to the beginning of assembly. 
The Assembler echoes tC and returns to the command string processor. CTRL C may also be used to return to the 
beginning of the command string if it is desired to change the options before starting the assembly. (Note that the 
keyboard reader start switch must be disengaged before typing CTRL C.) 

Examples 

(All characters underlined are typed by the Assembler) 

TAGl 00045:00200 tC 

*BIN- 
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A multiple definition error occurred and the user prematurely terminated the assembly by typing CTRL C. 
*BIN-^ 
*LST-H^ 



SMB- tC^ 



BIN- LJ 



CTRL C was typed to change the binary request from no binary output to binary output on the Teletype. 

Two pseudo-ops control the termination of a segment or total source input to assembly. They are .EOT and .END 
(see Sections 3.1 and 3.2). 

When .EOT is encountered by the Assembler it outputs EOT tP on the Teletype. It then waits for the user to load the 
next tape into the tape reader and type CTRL P to continue. 

When .END is encountered and another pass is required, the Assembler types END OF PASS tP. When the tape is 
reloaded in the reader for the next pass, the user types CTRL P to proceed. 



1.5.4 Assembly Output 

1.5.4.1 Symbolic Listing - If the user requests a symbolic listing, via the command string, the Assembler will 
produce an output Hsting on the requested output device. (Teletype or high-speed punch) 

The body of the listing will be formatted as follows. 

Error Flags Location Object Code Source Statement 

XXX XXXXX XXXXXX X X 

where 

Error Flags = Errors encountered by the Assembler (see Section 1.5.5) 

Location = Location assigned to the binary code. 

Object Code = The contents of the location (in octal) 

NOTE 

Locations and object codes assigned for hterals are listed following the 
program. 

When 56 lines have been encountered or when a form feed is encountered, the Assembler precedes the following 
output with a new page number. In the case of a form feed the Assembler also outputs three up arrows (ttt) 
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preceding the new page number, to indicate that a form feed caused the new page. At the end of the assembly hsting 
will be an error line count indicating any errors encountered during assembly. 



*3IN- 
*LST-L 

^SrtC-H 

uNu 

ENJ Or 
tP 

tp 



0t^l30 

PASS 



PAoE 



»j\dl id^ 



/THIS IS A COt^PLETE SAilPLE PROGRAil LISTING 
/THE LAST COLUi^lN CCO/ii*lENTS) CONTAINS THE 
/PARAGRAPH NU/JbER IN THIS l^ANUAL WHERE 
/FULL EXPLANATIONS ilAY BE FOUND. 
/ 

.LOG 100 /1. 4. 8 

.DEC /i.4.4 



jd01i^0 


000144 


ABC 


100; 


200 




iJkyl01 


000510 




.OCT 




/I .4.4 


^idU2 


777775 


DEF 


-3; 


+7 5 




k3^il^3 


000075 










z/iji04 


0001 12 


ADDR 


.DSA 


TAGl 


/I .4.6 


0^ik^5 






•BLOCK 


5 


/I .4.5.1 




00001 


A=10 






/I .3.2.2 




000020 


8=20 










000010 


C=A 








00112 


000155 


TAGl 


.SIZE 




/I .4.1 .1 


J0115 


010205 


TAG2 


.SIXBT 


/ABCD/ 


/I .4.5 


i^0i J4 


040000 
















.IFDEF 


A 


/i.4.7 


001 15 


i^d0^\6i 




1 






J0i 1 6 


000002 




2 
.ENDC 












.IFUND 

1 

.ENDC 


B 


/I. 4. 7 










/I .4.7 


k50il7 


600121 




J.^P 


.+2 


/I .5.4.1 


00Liiii3 


000000 


DAC 









00121 


200120 




LAC 


DAC 


/i .5.5.5 


0^122 


220010 




LAC't' 


C 


/I .5.4.5 


560123 


200151 




LAC 


(100 


/I - .^ - ii . S 


00124 


540152 




TAD 


(J.^P ABC) 


U iiicJl25 


000150 




UND 




/I .5.2.5 


.^ 00126 


200105 


DUPL 


LAC 


ABC+5 




Di*l 00127 


200126 


DUPL 


LAC 


DUPL 


/I .5.5.1 




000100 




.END 


ABC 


/i.4.l 


00161 


000100 










00152 


600100 











5 ERROR LINES 
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1.5.4.2 Symbol Table Output - After the assembly listing has been typed, the Assembler will output a symbol table 
(if requested) which Usts all user defined symbols. There will be two symbol lists; the first will be an alphabetically 
ordered list of the symbols and the second will be a list in numerical value order. The symbol table listing is useful in 
tracing or debugging a program for which the programmer does not have a complete assembly listing (symbols defined 
by labels will have a value of 5 octal digits and symbols defined by direct assignments will have a value of 6 octal 
digits). 



Sample Symbol Table Listing 


PAGE 


2 


M 


^^^\d\^ 


AdC 


^^\^\d 


adjh 


ti5Ji04 


d 


c)^i^^20 


G 


^m>d[\d 


JAC 


001k; 1^ 


)j^F 


i6i^l 02 


jupl 


^^126 


TAGi 


mi 12 


TAG^ 


»60113 


UND 


mih^ 



PAGE 



A 


n:^00010 


C 


^^Mi^ 


D 


^\dM2id 


AdC 


i^0UiJ 


i)iJ 


0i^l02 


hum 


00104 


TAGl 


00112 


IAG2 


00113 


DAC 


00120 


DuPL 


0012G 


UMi) 


00150 



1.5.4.3 Object Program Output - If the user requests binary output, the normal object code produced by the 
Assembler is a binary paper tape which can be loaded at run time by either of the hardware readin binary loaders (see 
Appendix D). The format of the binary output is as follows; 



Block Heading — (three binary words) 
WORD 1 
WORD 2 
WORD 3 



Starting address to load the block body which follows. 

Number of words in the block body (two's complement). 

Checksum of block body (two's complement). It also includes Word 1 
and Word 2 of the block heading. 



Block Body — (n binary words) 

The block body contains the binary data to be loaded under block heading control. 
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Starting Block — (two binary words) 



WORD 



WORD 2 



Locations to start execution of program. It is distinguished from the 
block heading by having bit set to 1 (negative). 

Dummy word 



If the value of the expression of the .END statement is equal to zero, the provided loader halts before transferring 
control to the object program, thereby allowing manual intervention by the user. (See Section 1.4.10 for an alternate 
form of binary output.) 



1.5.5 Error Detection and Flagging 



The Assembler examines each source statement for possible errors. The statement which contains the error will be 
flagged by one or several letters in the left-hand margin of the line. The following table shows the error flags and their 
meanings. 



Flags 

A 



Meaning 

Error in direct symbol table assignments ignored (see Section 2.5.1). 



Memory bank error (see Section L3.5.3). 



D 



The statement contains a reference to a multiply-defined symbol. It is 
assembled with the first value defined. 



Erroneous results may have been produced. Will also occur on 
undefined .END value (see Section 1.3.5.3). 



Literal phase error; literal encountered in PASS 2 does not equal any 
literal encountered in PASSl. 



M 



An attempt is made to define a symbol which has already been defined. 
The symbol retains its original value. 



N 



Error in number usage. 



O 



Operand error. Non-Memory Reference Instruction has an address 
value. 



Phase error; PASS I value does not equal PASS2 value of a symbol. 
PASSl value will be used. 
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Flag Meaning 

Q Questionable line 

S Symbol error; an illegal character was encountered and ignored. 

T TAG or LABEL error. 

1. Unrecognizable character in TAG field. 

2. A period used alone in a TAG field. 

3. A TAG begins with a number. 

4. X is used as a TAG. 

U An undefined symbol was encounterd. 

X Illegal use of Index Register. 

1. X occurs in a .DSA statement. 

2. X occurs more than once in an expression. 

3. X occurs in a TAG or OP-Code field. 

In addition to flagging error lines, the Assembler, during PASS 1 , will print the following conditions. 
Condition Example 

Multiple definitions ABC 00 1 00; 00 1 25 

Direct assignment forward references A = B 

Undefined symbols UNDF 06255 

The following condition will cause assembly to be terminated prematurely in PASS 1 . 
Message Cause 

TABLE OVERFLOW Too many symbols and/or literals 

1.5.6 Internal Operations 



1.5.6.1 Symbol Table Capacity - The Assembler occupies approximately 3000io memory locations, leaving about 
1090io registers free for symbols and Uterals. (The Assembler determines the physical size of memory of the 
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computer; therefore, if it is an 8K machine, 5190io registers are available for table space.) Each symbol defined by 
the user requires three memory locations and each literal requires one memory location. For a 4K PDP-15/10 this 
means that about 360i o symbols (or 300j o symbols and 190, o literals) may be used before overflow occurs. 

1.5.6.2 Halts - Normally, the Assembler does not halt for any reason except if an unknown program interrupt 
occurs. If this happens the machine halts with the status word in the AC. In order to clear the condition the user must 
deposit, in the location the program counter is pointing to, the instruction to clear the flag that caused the unknown 
interrupt, and then press CONTINUE. 
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CHAPTER 2 
COMPACT TEXT EDITOR 



2.1 INTRODUCTION 

The PDP-15/10 Compact Text Editor provides for the creation and/or modification of source programs and other 
ASCII text material. Commands issued from the Teletype direct the Editor to bring a group of lines from the input 
device to an internal buffer. The user may then, by means of additional commands, examine, delete, and change the 
contents of the buffer, and insert new text at any point in the buffer. When a block of lines has been edited, it is 
punched on the paper tape reader. 

Editor operation codes are divided into two basic categories: control instructions and Editor commands. Control 
instructions determine whether the Editor is to be used to create new ASCII material (input level) or to modify 
existing text (edit level). Within the edit level there are four Editor command classes: I/O requests, pointer 
manipulation, editing requests, and examination requests. 

The Editor is most frequently used to modify PDP-15/10 source programs, but it also can be used to edit any 
symbolic text. The Editor operates with either high-speed or low-speed (ASR33) paper tape devices, and occupies 
approximately 2000 1 o locations of core memory. Any additional memory is used for buffers. 

Appendix E provides a concise summary of Editor commands. Appendix F contains a simple procedure for creating 
ASCII text using the Editor. Appendix G contains examples of Editor operation, written for the user who is not 
familiar with the Editor, but wishes to edit an ASCII tape immediately. The user should at least read 2.3, Operating 
Procedures, before attempting to use the Editor as described in Appendix G. A more comprehensive, annotated 
example of an actual editing session is contained in Appendix H. 



2.2 FUNCTIONAL DESCRIPTION 

2.2.1 Input Format 

The following paragraphs describe the control levels, operation code formats, and data modes for the Editor. 
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2.2.1.1 Control Levels - The PDP-15/10 Compact Editor operates on one of two control levels: input or edit. The 
input level is used to create new text material; on this level the Editor interprets lines from the Teletype as text to be 
added to an open block. Instructions are available to conveniently change the control level. The edit level is used to 
modify existing text; on this level the Editor accepts and acts upon control words and data strings to bring in lines of 
text, to change, delete, or replace the line currently in the work area, and to insert single or multiple lines after the 
current Hne. 



2.2.1.2 Operation Code Format - The format for all Editor operations consists of the operation code, followed by a 
«— » (space), followed by arguments where appUcable. The space is a blank delimiter which is considered by the 
Editor to be a part of the command itself, not part of the argument string which follows the command. Legal 
abbreviations are indicated with square brackets in this manual. Certain commands (e.g., FIND and RETYPE) require 
the presence of arguments. Others (DELETE, NEXT) may take explicit arguments at the option of the user. Optional 
arguments are given in parentheses. For a description of the command language see 2.4. 



2.2.1.3 Data Mode - The Editor can accept input from a maximum of two devices* in addition to the keyboard. The 
first device normally holds previously prepared text upon which changes are to be carried out. The second, the 
subsidiary input device, is usually the medium through which additional, previously prepared text is inserted in the 
object text. 

Data from the input device is made available for editing in block form, A user-specified portion of the input is held in 
a core buffer for editing until the user requests that the contents of the buffer be added to the output text. 
Commands to the Editor are performed on that portion of the text currently in the buffer. Lines may be accessed 
repeatedly until the buffer is emptied by the user. The lines of text in the buffer are made available for modification 
by manipulating a software pointer (see Figure 2-1). 



POINTER 



~\ 



PSEUDO LINE 



)> LINES OF ASCII TEXT 



Figure 2-1. Line Buffer and Software Pointer 



2.2.2 Output Format 



The teleprinter is used by the Editor to echo user requests, to make responses to those requests, and to print error 
messages. Edited text is punched out on either the low-speed (ASR33) or the high-speed paper tape punch (if 
available and requested by the user during the initialization sequence). Edited source programs are punched in a form 
that is ready to be read by the Assembler; parity is not punched; channel 8 8 is always punched (see Figure 2-2). 

*The low-speed (ASR33) paper tape reader, and a high-speed paper tape reader (if available). 
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A 



DIRECTION OF 
TAPE MOVEMENT 



O O 



O O O O O O 



o O O O 



O O o O O 




CHANNEL 8 


(ALWAYS PUNCHED) 


CHANNEL 7 




CHANNEL 6 




CHANNEL 5 




CHANNEL 4 




TAPE -SPEED 


SPROCKET HOLES 


CHANNEL 3 




CHANNEL 2 




CHANNEL \ 




FRAME n 




FRAME n + 1 




FRAME n + 2 




ETC 




OCTAL 000- 


NULL FRAME 


OCTAL 015= 


CARRIAGE RETURN 


OCTAL 012= 


LINE FEED 


OCTAL 1 CO- 


® 


OCTAL 10 1^ 


A 


OCTAL 10 2 = 


B 


O = HOLE POSITION 


• = HOLES PUNCHED 



Figure 2-2. PDP-1 5/ 10 ASCII Tape Format 
2.3 OPERATING PROCEDURES 
2.3.1 Loading Procedure 

Prior to loading the Editor, proceed as follows to generate leader: 

Turn Teletype switch to OFF LINE. 

Press punch switch ON. 

Press HERE IS key several times to generate leader. 

Press punch switch OFF. 

Turn Teletype switch to ON LINE. 

The loading procedure used depends on whether the low-speed (ASR33) or high-speed paper tape reader is used as the 
loading device. 

2.3. 1 . 1 Low-Speed Reader The low-speed reader loading procedure is as follows: 

Place paper tape containing low-speed, hardware readin binary loader in the Teletype reader. 

Turn reader switch to ON 

Set ADDRESS Switches to 7700 (17700 for 8K systems). 

Press I/O RESET and READIN. The computer will halt (AC-777777). 



2-3(Part II) 



Turn reader switch to OFF and place binary tape of Editor in Teletype reader. 

Turn reader switch to ON and press START. The Editor will be loaded into memory and will type EDITOR on the 
Teletype. 



2.3. 1 .2 High-Speed Reader - The high-speed reader loading procedure is as follows: 

Place paper tape containing high-speed, hardware readin binary loader in the high-speed paper tape reader. 

Set ADDRESS Switches to 7720 (17720 for 8K systems). 

Press I/O RESET and READIN. The computer will halt (AC=777777). 

Place binary tape of Editor in high-speed reader and press START. The Editor will be loaded into memory and will 
type EDITOR on the Teletype. 

2.3.1.3 Loader Halts 

AC - 777777 Program loaded. 

AC = non-zero Checksum error on last block loaded. Reposition tape to blank frame prior to 
beginning of last block and press START to read again. To ignore error, press 
CONTINUE. 



2.3.2 Initialization 

The Editor always begins with control at the edit level and assumes that the user wishes to modify some existing text. 
When first loaded, or when restarted, the Editor types EDITOR, followed by the I/O initialization request sequence 
(the underlined portion is typed by the Editor). 



Select input device: 
Select subsidiary device: 
Select output device: 



INTXT* ^ 
H,Lj ^ 
GETXT*\ 

OUTXT*^ 
HX 



■\ 



User specifies high-speed (H) 
or low-speed (H) paper tape 
device,^ = carriage return. 



J 



The user's response to INTXT* initiaUzes the Editor to handle the READ command. If it is LJ ,the low-speed reader 
on the Teletype is used to read ASCII text into the block buffer for editing. If the response is H J , the Editor expects 
to find the ASCII text on the high-speed paper tape reader. Similarly, the user's response to GETXT* initiaUzes the 
Editor to handle the GET command by selecting the high- or low-speed reader as the subsidiary device. (The user may 
specify that the same device be used for both READ and GET.) The response to OUTXT* selects the output device, 
initializing the Editor to handle the WRITE command on the high- or low-speed punch. To obtain a listing of the 
edited text, the user must specify the ASR33 punch as the output device by responding to OUTXT* with L J . 

The carriage return is the signal to the Editor to process each step in the initiaUzation. The Editor interprets only the 
letter immediately preceding the carriage return to be the desired device selection (i.e., HXL \ is equivalent to Lj ). 
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If that letter is not an H or L, the Editor assumes that a mistake has been made and repeats the initialization message. 
If the user's response specifies the device that is not ON, or is not even part of the system, the Editor goes into an 
indefinite loop, the first time it attempts to use that device, waiting for a response from a device that is not available. 
In that event, the Editor may be restarted (press STOP, set the Address switches to 228, ^"d press START) and 
reinitialized. 

2.3.3 Operation 

All text in the buffer is available for editing until a WRITE command is issued or until each individual line is deleted. 
Using a block buffer has the advantage of rapid correction of command errors. If the user finds that he has typed the 
wrong command, he can immediately correct it since the buffer has not yet been added to the output file. 

If the ASR33 is the output device, the punch switch must be OFF except when actually outputting edited text (see 
Paragraph 2.3.3.2). This avoids contamination of the output tape by command echoing and typing of Editor 
commands. The Teletype punch must be specified as the output device to obtain a listing. 

2.3,3.1 Editor Break (CTRL P) — Frequently, having made a mistake in his command string, the user may wish to 
stop processing and reissue his command. When the user types the break character CTRL P (formed by depressing the 
CTRL key while striking P) during command processing, the normal instruction sequence is interrupted as soon as 
processing of the current line has been completed. 

Control is transferred from the command processor to the edit command decoder. The Une after the line that was 
being processed when CTRL P was typed is left in the work area as the current line for examination or modification. 
The Editor then awaits a new command from the keyboard. 

The break character (echoed as TP) results in program restart when the Editor is waiting for a command. On input 
level, the break character results in a transfer of control to the edit level (see paragraph 2.4. 1.2). 



2.3.3.2 Editor Continue — If the INTXT* device is the Teletype, the Editor halts after a READ. The user must turn 
the Teletype reader switch to OFF and then press CONTINUE. Similarly, if the GETXT* device is the Teletype 
reader, the Editor halts after a GET to allow the user to turn the reader switch to OFF and press CONTINUE. If the 
OUTXT* device is the Teletype punch, the Editor halts twice in the execution of a WRITE. After the 
command-terminating carriage return, the Editor halts to allow the user to turn on the punch, thus avoiding 
contamination of his output tape. When punching stops, the Editor halts and waits for the user to press CONTINUE 
as a sign that the Teletype punch has been turned off, and messages may be typed safely. 



2.3.3.3 Editor Recovery — If a paper tape reader out-of-tape condition occurs during the execution of a command, 
the user can recover by typing CTRL R (formed by depressing the CTRL key while striking R). 

2.3.3.4 Using the Erase and Kill Characters - The Editor allows the use of two keyboard characters for correction of 
the line currently being typed by the user. The RUBOUT key (erase character) results in the deletion of the 
immediately preceding character. The Editor echoes a backslash (\) for each RUBOUT typed. CTRL U ("kill hne" 
character) results in deletion of the entire line typed so far. CTRL U is formed by depressing the CTRL key while 
striking the letter U. The Editor echoes an at sign (@) each time CTRL U is typed. 



2.3.3.5 Editor Restart - To restart the Editor at the beginning of the initialization sequence, the user should press 
STOP, set the Address switches to 228 . and press I/O RESET and START. 
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If, during command processing (especially FIND and LOCATE), the Editor attempts to move the current-line pointer 
past the end of the block buffer, it is assuming the user has made a mistake and types 

END OF BUFFER REACHED BY: 

followed by the command string. The user must issue a TOP request if further modifications to the current block are 
required. 

If the user requests SIZE i— in, where n is greater than the number of full-length lines that the block buffer can hold, 
the Editor types 

CAPACITY WARNING 

The user may respond with CTRL U to proceed as though the SIZE i_i n request were never issued, or he can type a 
carriage return to ignore the warning and continue. If the user types a carriage return, the command is processed and 
the Editor's buffer capacity may be exceeded. 

CAPACITY WARNING is also typed when the Editor calculates that execution of a command will result in more than 
SIZE or the internal parameter SYSMAX (whichever is greater) lines in the buffer. Again, the user has the option of 
killing the command (CTRL U) or of processing it anyway (carriage return). The Editor calculates the number of lines 
in the buffer without regard to their length. For example, with a 4K system, the Editor could easily hold 30 lines of 
CAP- 15 assembly language instructions without comments. Thus 

>SIZE 1-1 30 
CAPACITY WARNING 
>READ 
> 

would be extremely dangerous if the user intends to add extensive commands throughout his code with the APPEND 
command. Since the APPEND command does not change the number of lines in the buffer, the user would receive no 
additional capacity warnings unless he attempted to use INSERT, INPUT, or GET. 

2.3.4 Error Recovery 

Operator command errors are detected by the Editor. The message 

NOT A REQUEST: 
is typed, followed by the command string in error. The user should then retype his command in the correct form. 

2.4 COMMAIMD LANGUAGE 



2.4.1 Control Commands 

Editor control commands consist of three commands that cause the Editor to enter the input level, and one command 
to enter the edit level. (Control is initially at the edit level). These commands are described in the following para- 
graphs. 
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2.4.1.1 Transfer from Edit to Input Level - Any one of the following three commands causes the Editor to transfer 
control from the edit level to the input level. 

a. Carriage return (J ) typed as the first character on a line. 

b. The INSERT command (see Section 2.4,4.4) with no arguments. In this case the current line is added to the 
output before the control level is changed. 

c. The OVERLAY ( i-j n) command (see Section 2.4.4.7). In this case, n lines (or the current line only if n is 
omitted) are deleted from the buffer before the control level is changed. 

2.4.1 .2 Transfer from Input to Edit Level - A carriage return typed as the first character of a line when operating in 
the input level causes the Editor to transfer control from input level to edit level. The user can also change the control 
level by typing CTRL P (formed by depressing the CTRL key while striking P). When control has been transferred to 
the edit level, the Editor awaits the next command from the Teletype. The line after the line that was being processed 
when CTRL P was typed is left in the work area as the current line, ready for examination or modification. 



2.4.2 Editor Commands 

2.4.2.1 SIZE [S] { i_j n) - Set the total number of lines that will occupy a buffer to n. The SIZE command may 
be issued at any time, and takes effect when the next group of lines is loaded into the buffer via a READ command. 
The integer variable n is initially set to 20io for a 4K system, or 55io for an 8K system, and must always be set 
greater than 1 . 

2.4.2.2 READ J - Reads sequential lines from the input device, loading them into the buffer as they are 
encountered, until the number of lines in the buffer is equal to the argument specified in the SIZE request. The 
pointer is set to the first line of the buffer when the operation is complete (see Figure 2-3). The READ request will 
not be accepted if any lines remain in the current buffer. The buffer must have been cleared by DELETE requests or a 
WRITE command.* 



POINTER 




PSEUDO LINEtBLANKl 



LINES READ FROM INPUT 
DEVICE AS SPECIFIED 
BY SIZE REQUEST 



Figure 2-3. Line Buffer After READ Command 



*If the input device runs out of tape, the user may terminate the processing of this command by typing a CTRL R on the Teletype. 
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If more than one block of text is to be read, the READ command inputs the first line of the next block into an 
intermediate buffer. This means that if the user changes tapes on the input device between READs, he will find the 
*'next line" from the previous tape at the top of the block buffer, followed by SIZE-1 lines from the new tape. This 
does not occur if GET is used to input the new tape into the block buffer, since GET does not use an intermediate 
buffer. 



NOTE 



If the input device is the low-speed paper tape reader, the Editor halts at the 
beginning of a READ to allow the user to turn on the reader. Also, the Edi- 
tor halts at the completion of a READ to allow the user to turn off the 
reader; the user should press CONTINUE to proceed. 



2.4.2.3 GET [G] ( i_, n) ^ - The next n lines from the subsidiary input device are added to the buffer below the 
current line. When command processing is complete, the nth line read is left in the work area as the current line. If n 
is omitted, it is assumed to be 1 . The pointer remains at the last line read (see Figure 2-4), 



2.4.2.4 RENEW^ - The contents of the block buffer are written on the output device and a new block is read into 
core,* 



2.4.2.5 WRITE J - Punches the current contents of the block buffer on the OUTXT device, and clears the buffer.* 

2.4.2.6 CLOSER — This command must be preceded by a WRITE request. The remainder of the input file is then 
written on the output device.* 

2.4.3 Pointer Manipulation 

The pointer is a software device that places the current line in a work area to facilitate editing. After a page of text 
has been read, the pointer is positioned at the top of the block buffer to allow the user to insert text before the first 
line in that block. This is done by keeping a pseudo line in the buffer which is never punched out. Thus, the first line 
of the text in a block is the "second" line in the buffer. Consequently, the first line of the block of text in the buffer 
is shifted one position to the right when examined with the PRINT command. This "space" is not printed. The 
following paragraphs describe commands that enable the user to manipulate the pointer. 

2.4.3. 1 TOP [T]^ - This command moves the pointer to the beginning of the edit block buffer. The first line of the 
buffer becomes the current line (see Figure 2-5). 



*If the output device is the low-speed punch, the Editor Continue feature provides protection against output contamination (see para- 
graph 2.3.3.2). 
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POINTER 






(BEFORE GET) 
POINTER ^ 








(AFTER GET) 









PSUEDO LINE 



CURRENT LINE 

"N BEFORE GET 



> 7]- 1 LINES 



77'" LINE (CURRENT 
LINE AFTER GET) 



LAST LINE 
IN BUFFER 



GET 7] ISSUED WITH POINTER WITHIN BUFFER 



POINTER ^ 

(BEFORE GeT) ^ 



POINTER 



(AFTER GET) 




PSEUOO LINE 



-TJ^'^LINE 



LAST LINE IN SUFFER 







POINTER 




(BEFORE GET)^ 







PSEUDO LINE 



POINJER 
(AFTER GE 



•LAST LINE IN 
BUFFER 



Tl- 1 LINES 



GET 7] ISSUED WITH POINTER AT TOP OF BUFFER 



^ ^ J ^7,*V,NE 

GET 7| ISSUED WITH POINTER AT BOTTOM OF BUFFER 



NOTE: If GET n attempts to exceed the maximum line buffer size, CAPACITY WARNING will be typed. The user 
may type a carriage return (J ) to ignore the warning and continue, or he may type CTRL U to proceed as though the 
command were never issued. 



Figure 2-4. Line Buffer After GET Command 



NOTE 



If the input device is the low-speed paper tape reader, the Editor halts at the 
beginning of a GET to allow the user to turn on the reader. Also, the Editor 
halts at the completion of a GET to allow the user to turn off the reader; the 
user should press CONTINUE to proceed. 
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r- VIM 1 en 




(AFTERTOP) 




PO t NTPR 








(BEFORE TOP) 





PSEUOO LINE 

FIRST LINE OF TEXT 



POSSIBLE POSITION OF 
CURRENT LINE BEFORE 
TOP COMMAND 



Figure 2-5. Line Buffer After TOP Command 

2.4.3.2 NEXT [N] ( i_i n)^ - The pointer is moved past the next n Hnes, beginning with the line currently in the 
work area. Line N+1 is brought into the work area for modification (see Figure 2-6). If omitted, n is assumed to be 1. 
If the command results in the pointer moving past the last line of buffer, the error message 

END OF BUFFER REACHED BY: 

NEXT n 

is printed and the pointer is moved to the top of the buffer. 



PSEUOO L INE 

Fl RST LINE OF TEXT 



CURRENT LINE 

>7^ - I LINES 

LINE 7] + ) (NEW "CURRENT" LINE) 











POINTER 






(BEFORE NEXT ) 

POINTER ^ 








(AFTER NEXT) 





Figure 2-6. Line Buffer After NEXT Command 



2.4.3.3 FIND [F] l_i string^ - This command searches the buffer for the next line that begins with the character 
group "string". The search begins with the line following the current line. If the search is successful, the line beginning 
with "string" is brought into the work area (see Figure 2-7). If the search is unsuccessful, the END OF BUFFER 
message is printed and the pointer is moved to the top of the buffer. "String" may contain any number of characters. 



2.4.3.4 LOCATE [L] t_j string J| - This command searches the buffer for the next occurrence of a line that 
contains the character group "string." The search begins with the line following the current line. If the search is 
successful, the hne containing "string" is brought into the work area (see Figure 2-8). If the search is unsuccessful, the 
END-OF-BUFFER message is printed and the pointer is moved to the top of the buffer. "String" may contain any 
number of characters. 
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POINTER 










(BEFORE FIND) 
POINTER 








(AFTER FIND) ^ 





PSEUDO LINE 



CURRENT LINE (BEFORE 
FIND IS EXECUTED ) 



CURRENT LINE (AFTER 
FIND IS EXECUTED) 
OR LINE BEGINNING WITH 
"STRING" 



FIND STRING WHEN "STRING" IS FOUND 



POINTER 



(AFTER FIND) 



(BEFORE FIND) 



PSEUDO LINE (CURRENT LINE 
AFTER FIND IS EXECUTED) 



CURRENT LINE (BEFORE 
FIND IS EXECUTED) 



FIND STRING WHEN STRING IS NOT FOUND 



Figure 2-7. Line Buffer After FIND Command 



2,4.3.5 BOTTOM [B] ^ — This command moves the pointer to the beginning of the last line in the buffer. The last 
line is typed on the Teletype (see Figure 2-9), 



2.4.3.6 SEARCH i-j string - The entire input tape is searched for the next occurrence of a line beginning with the 
character group "string." This command must be preceded by a WRITE to clear the block buffer. If the search is 
successful, the line beginning with "string" is brought into the work area with the remainder of the buffer left empty 
for inputting new text or large inserts for the subsidiary input device using the GET command. 



NOTE 



If the output device (OUTXT*) is the Teletype punch (L), the Editor will 
halt at the beginning of a SEARCH to allow the user to turn on the punch. 
The user should press CONTINUE to proceed with the SEARCH. When the 
Une beginning with "string" has been found, the Editor will again halt to 
allow the user to turn off the punch. Again, the user should press 
CONTINUE to proceed. 
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(BEFORE LOCATE 



POINTER 



(AFTER LOCATE! 



PSEUDO LINE 



CURRENT LINE 

(BEFORE LOCATE IS EXECUTED) 



CURRENT LINE 

(AFTER LOCATE IS EXECUTED) 

OR LINE CONTAIN! NG "STRING 



LOCATE STRING W HE N " STR I N G " IS FOUND 



P0INT£R_ 
(AFTER LOCATE) 



POINTER^ 
(BEFORE LOCATE ) 



PSEUDO LINE 

(CURRENT LINE AFTER LOCATE 

IS EXECUTED) 



CURRENT LINE 

(BEFORE LOCATE IS EXECUTED) 



LOCATE STRING W H EN "STR I NG " IS NOT FOUN D 

Figure 2-8. Line Buffer After LOCATE Command 

2.4.4 Editing Requests 

The following paragraphs describe commands that enable the user to accomplish his actual editing task. 

2.4.4.1 RETYPE [R] ^-i Hne^ - The character string "line" replaces tiiQ current line. The new line is left in the 
work area and may be modified. 

2.4.4.2 APPEND [A] i— i string^ - "String" is added to the current line following the last character preceding the 
terminating caniage return. Thus, to add a comment to the current line 

JMS GETNUM J 

the command might be 

A i_j -^ /Get decimal argument. J NOTE: H indicates a tab 
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POINTER 



(BEFORE BOTTOM) 



POINTER 



(AFTER BOTTOM) 



PSEUDO LINE 

FIRST LINE OF TEXT 



CURRENT LINE 

(BEFORE BOTTOM IS EXECUTED) 



LAST LINE IN BUFFER 
(CURRENT LINE AFTER BOTTOM 
IS EXECUTED) 



Figure 2-9. Line Buffer After BOTTOM Command 

The new current line would be: 

JMSGETNUM -*\ /Get decimal argument. ^ 

If "string" is absent, the current line is unchanged. When the current line is changed, the new line is left in the work 
area and may be modified. 

2.4.4.3 CHANGE [C] l-j qstring1qstring2q^ ~ In the current line, the first character group (stringl) which 
matches that occurring between the first pair of delimiting characters (q's in this case) is replaced by the character 
group (string2) appearing between the second pair of deUmiting characters. The delimiting characters are chosen by 
the user and can be any character (including blank) that does not appear in either of the character strings. Both 
"stringl" and "string2" may contain any number of characters, including zero. If VERIFY is ON (see paragraph 
2.4.5.2), the program will print the new current line on the Teletype when the request change has been accomplished. 
The new hne is left in the work area and may be modified. 



Examples 



Current Line: 



NXTLIN 



JMS TYPOUT 



/PRNT THE LINE. 



a. In the comment, spell PRINT properly, 



JMS TYPOUT 



REQUEST: CHANGEi_i/RN/RIN/j 

NEW LINE: NXTLIN JMS TYPOUT 



/PRINT THE LINE. 
/PRINT THE LINE. 



b. Make the "JMS" a "JMP". 



REQUEST: 

NEW LINE: 



CHANGE i_i XSXP*X^ 

NXTLIN JMP* TYPOUT 



/PRINT THE LINE. 
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c. Delete the "T" in the tag, 



REQUEST: 

NEW LINE: 



C L-- nil) 

NXLIN 



JMP* TYPOUT 



/PRINT THE LINE. 



2.4.4.4 INSERT [I] i_i line - The character string "hne" is inserted below the current line. The pointer is stepped 
to place "line" in the work area and "line" becomes the new current line (see Figure 2-10). The program remains at 
the edit level when the request processing is completed. 



(BEFORE INSERTl 
POINTER 



POINTER 
(AFTER INSERT) 



PSEUDO LINE 



CURRENT LINE(BEFORE INSERT COMMAND) 
INSERTED LINE OR CURRENT LINE AFTER 
INSERT COMMAND. 



Figure 2-10. Line Buffer After INSERT Command 

2.4.4.5 GET [G] ( i„j n)^ -This command adds n lines from subsidiary input device to buffer below the current 
line (see Section 2.4.2.3). If the subsidiary device runs out of tape, the user may terminate processing of this 
command by typing CTRL R on the Teletype. 



2.4.4.6 DELETE [D] ( i_j n)^ - The next n lines, including the current line, are deleted from the buffer. The line 
following the last line deleted becomes the current line (see Figure 2-11). If n is omitted, only the current line is 
deleted. If n is large enough to cause the pointer to pass the end of the buffer, the END-OF-BUFFER message is 
printed and the pointer is moved to the top of the buffer. 



2.4.4.7 OVERLAY [O] ( l_, n)^ - Starting with the current line, n lines (or the current line only, if n is omitted) 
are deleted from the buffer and the control level is changed to input level. When control returns to edit level, the 
pointer will be positioned at the last line typed by the user. 



2.4.5 Examination Requests 

The following paragraphs describe commands that allow the user to examine text within the block buffer. 



2.4.5.1 PRINT [P] ( i_j n)J - The next n lines from the buffer, including the current line, are printed on the 
Teletype. The pointer is left at the last hne printed (see Figure 2-12); n is assumed to be one if omitted. 



If, as a results of the request, the pointer moves past the last line of the buffer, the 



error message 



END OF BUFFER REACHED BY: 
PRINT n 
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is printed and the pointer is moved to the top of the buffer (see Figure 2-12). 



POINTER 
(BEFORE DELETE) 



POINTER 
(AFTER DELETE) 




PSEUDO LINE 



CURRENT LINE (BEFORE DELETE) 
7]-1 LINES DELETED 
LINE ?] + MNEW "CORRECT" LINE) 



DELETE Tl THAT DOES NOT REACH END OF BUFFER 



POINTER 



(AFTER DELETE) 



POtNTER 



(BEFORE DELETE) 



(CURRENT LINE AFTER DELETE) 



PSEUDO LINE 



CURRENT LINE (BEFORE DELETE) 



> LINES DELETED 



y 



DELETE Tl THAT REACHES END OF BUFFER 

Figure 2-11. Line Buffer After DELETE Command 



/on\ 



2.4.5.2 VERIFY [V] ,_, yOFFIJ- Set Editor response according to the parameter. When VERIFY is ON, text 
lines are printed in response to certain editing requests, as follows: 

a. The line brought into the work area as a result of a FIND or LOCATE request is printed. 

b. The last line of the buffer, brought in by the BOTTOM request, is printed. 

c. The new line resulting from a CHANGE request is printed. 



When VERIFY is OFF, only error messages are printed. After the Editor is loaded initially, VERIFY is ON. The 
verify request without arguments is equivalent to requesting VERIFY ON. 
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POINTER 
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PSEUDO LI NE 



CURRENT LINE (BEFORE PRINT) 

^17-2 LINES PRINTED 

7}^^ LINE PRINTED OR CURRENT 
LINE AFTER PRINT 



PRINT T( THAT DOES NOT REACH END OF BUFFER 



KUIINItK ^ 






(AFTER PRINT) 
POINTER 








(BEFORE PRINT)'* 





PSEUDO LINE 

(CURRENT LINE AFTER PRINT) 



CURRENT LINE (BEFORE PRINT) 



>LINES PRINTED 



END OF BUFFER MESSAGE TYPED 
PRINT 7^ THAT REACHES END OF BUFFER 



Figure 2-1 2. Line Buffer After PRINT Command 



^ (off K 



2.4.5.3 BRIEF uj \^^^/J- Set Editor verification according to the parameter. BRIEF ON results in the abbre- 
viated printing of the current line when responding to edit requests. An attempt is made to print only the tag, opera- 
tion code, and address fields of lines brought into the word area as a result of the FIND, LOCATE, and BOTTOM 
requests. The printing of the new line resulting from a CHANGE request is terminated at the last newly inserted 
character. BRIEF is initially set to OFF. The setting of this indicator is of no consequence when VERIFY is OFF. 
The brief request without arguments is equivalent to BRIEF ON. 
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CHAPTER 3 
OCTAL DEBUGGING TECHNIQUE 



3.1 INTRODUCTION 

Octal Debugging Technique (ODT) is a debugging aid that allows the user to conduct an interactive, on-line debugging 
session using octal numbers and Teletype commands. The program, which is self-contained and completely 
independent, is designed to run on a basic 4K or 8K PDP- 15/10 with an ASR33 and will operate with PI or API 
enabled. ODT is written in CAP- 15 Assembly Language and may be assembled along with the user programs with 
which it is to run. All symbols that are internal to ODT begin with a percent sign (%). Thus, if the user avoids 
beginning his own symbols with this character, multiple definition of symbols will not occur when ODT is assembled 
with the user program. However, ODT would normally be assembled separately from the user's programs and then 
loaded into memory only when desired. Standard versions which are delivered in object program form may be used 
for the debugging of any programs as long as enough memory is available to load ODT at the proper locations. 



Using ODT, the programmer can conduct a debugging session, and when errors are found, correct them on-line and 
execute the program immediately to test the correction. Thus, ODT can be used to compose a program on-line and 
check it out as composition progresses. Manual operation of console controls is not required to operate ODT; all 
functions are initiated by typing commands on the Teletype.. The source coding for ODT is so designed that many 
features can be removed by defining parameters at assembly time. This will be of prime interest to users who are 
checking out large programs and wish to conserve core storage. 

Appendix I provides a convenient listing of the Teletype code in octal form. Appendix J is a concise listing of ODT 
commands. 



3.2 GENERAL DESCRIPTION 

All input to ODT is initiated through the console Teletype keyboard. In general, the user types commands to ODT 
which control the following operations: 

Starting the user program at any point. 
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Stopping and subsequently continuing the user program at selected points called breakpoints. 
Examining and/or modifying the AC and Link at a breakpoint. 
Examining and/or modifying any memory locations (registers). 
Searching user defined areas for registers with specified bit configurations. 

Punching out areas of memory to be loaded later for more debugging and/or execution. 

Initializing buffer areas to any desired value. 

Selection of hardware options such as a high-speed or low-speed paper tape punch. 

There are two outputs from ODT: teleprinter and paper tape punch (either high-speed punch or ASR33 punch). The 
teleprinter is used by ODT to type all information concerning register contents and error indications. This output is 
very useful since it contains the user's commands as well as ODT responses, which can be analyzed off-line if 
necessary. The paper tape punch is used to save or dump the user program, or portions of it, as the user desires. The 
tapes generated when dumping a program are fully checksummed and can be loaded by thePDP-15/10 Loader. The 
format of this tape is shown in Figure 3-1. Each memory word consists of three data frames of six bits each. The 
program start address is distinguished from the other load addresses by having bit set to 1. 



> 



Leader ($F command) 
2 feet 



-y 



Figure 3-1. PDP-15/10 Loader Format 
3.2.1 Operational Organization 

ODT can be loaded and used in four basic ways: 

It can be loaded immediately following the user program, with control being given to ODT after it is loaded. 

It can be loaded after the user program has been running. 

It can be loaded before the user program(s) and initiated by manual control after the user program(s) has been 
running. 

It can be loaded by itself and used as a stand-alone program. 
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^ 



"^ 



J 



Block Start Address 



^ 



^ of words In block (2's complement) 

Checksum of block including the previous 
two words (2's complement) 



> Block Body (any length) 



Block Spacer (10 Frames) 



>• More Data Blocks 



y Last Data Block 



Program Start Address 



^ 



Dummy word 



Data Block 



^(k,; k- $D command) 



J 



> Trail 



V Terminal Block (k$T command) 



er 



^ 



Figure 3- 1 . PDP- 15/10 Loader Format (cont) 
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In any case, ODT is initiated by starting the processor at location %ODT. The distributed version is loaded and 
initiated at location %ODT (6000 for 4K and 16000 for 8K). However, the user may assemble versions of ODT which 
are loaded at any location in memory. Also, by choice of .END statements, ODT may be initiated automatically by 
the loader or may require manual initiation at location %ODT. Once initiated, the user has control over running and 
stopping his program with keyboard commands. If ODT breakpoints are requested, the following modifications are 
made to the user program: 



Each instruction that the user designates as a breakpoint is replaced with JMS* AUTOX. This instruction gives 
control to ODT when the breakpoint is encountered, and is removed when a breakpoint is executed so that the user 
will see his own instructions if he examines these locations or dumps memory. 

An auto-index register, the address of which may be examined and/or modified by using the $V command, is used 
by ODT and may not be modified or referenced by the user program. 

If the PI (program interrupt) is used, ODT must, during breakpoints, intercept all TTY interrupts and pass all other 
to the user. Therefore the instruction at location 1 is replaced with the instruction JMP %INT. Location 1 is 
restored when a dump is performed but it is not restored during other ODT operations. 



3.2.2 Functional Organization 

The internal organization of ODT is almost totally modularized into independent subroutines. In general, the internal 
structure consists of major functions, as follows: 

Initialization 

TTY Character Input/Output 

TTY Message Output 

PI Intercept 

Command Decode 

Command Execution 



3.2.2.1 Initialization - This function is performed when ODT is started at location %ODT. The tasks performed 
include disabling the entire system (similar to an I/O reset), resetting miscellaneous registers internal to ODT, clearing 
all breakpoint requests, clearing hardware and software flags, and initiating the command decode function. 



3.2.2.2 Teletype Character Input/Output - All teletype communication is performed a character at a time; that is, 
the input and output is not buffered. This means that the user must not type commands unless ODT is waiting for 
one. If characters are typed while a requested operation is in progress, they will not be seen by ODT and will not be 
echoed on the teleprinter. 
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3.2.2.3 Teletype Message Output — This function is performed by repeated use of the teletype character output 
routine. The functions performed include the typing of addresses, register contents, operational messages and error 
messages. 



3.2.2.4 PI Interrupt — If the PI is enabled, the Teletype will interrupt when it is ready for service. Therefore, during a 
breakpoint, ODT must be able to handle the Teletype I/O interrupts. This function is performed with the help of the 
PI Intercept (%INT) routine. This routine is entered, instead of the users interrupt program, on every program 
interrupt which occurs while ODT has control. If the interrupt is not from the Teletype, control continues to the user 
trap program. 



3.2.2.5 Command Decoder- The functions performed by the command decoder include: 
Reading the keyboard. 

Assembling and saving all octal numbers typed by the user. 
Detecting the command character. 

Allocating control to the proper command execution subroutines. 
Detection of illegal numbers and commands. 



3.2.2.6 Command Execution - In general, each command has a separate entry point into the command execution 
routines. These routines are entered from the command decoder. They exit either to the user's program ($G, SC) or 
back to the command decoder to interpret the next command. 



3.3 COMMAND LANGUAGE 

The following conventions are used throughout this section and the remainder of this chapter: 
$ represents either the ALT MODE key or the dollar sign (S) key ($ is echoed). 

k represents an octal number of six or less digits. When used to specify an address, k is five or less 
octal digits. 

n represents a single octal digit. 

^ represents carriage return 

i represents line feed. 

T (up arrow) is formed by depressing the shift key and typing N. 

Any underlined text in the examples refers to that which is typed by ODT. 
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Aindicates a blank or space. 

Priority levels are specified as follows: 
Highest 

1 

2 
3 
4 
5 
6 
7 



Hardware API levels. 



Software API levels. 



PI level 
Program level 



Optional 



Lowest 9 <- 

When a command is typed by the user, ODT responds in one of the following ways: 

If the command does not require a typed response, ODT will respond with a carriage return and line feed (^1) to 
indicate that the command has been accepted. On this type of command, the user should not type anything on the 
keyboard until after ODT has typed the^ i. Anything typed after the command and before the^ i will be ignored; 
in fact, it won't be echoed on the teleprinter. 

On commands that request the contents of a register to be displayed, ODT performs the typed response but does 
not follow with the^l; this allows modification and/or other commands to be typed on the same line. 

On commands that cause multiple words, messages, or multiple lines to be typed, ODT terminates the output 
within. 

Illegal or incorrect commands are ignored, and ODT responds with Ij i. 
3.3.1 Register Examination and Modification 

The following paragraphs describe all ODT register examination and modification commands. 



3.3.1.1 Open a Register (k/,/) - The command k/ causes ODT to open register k. This means that ODT fetches the 
contents of register k, types the contents on the teleprinter, and then leaves the register open for modification. Once a 
register is opened, the user may close it, or he may type a new octal value for the register and then close it. ODT 
allows only one register to be open at any particular time. Thus, another register-opening command will close the 
open register. 

The / command causes the last referenced register to be opened. This allows the user to open and close register N, 
perform some non-register-opening commands (possibly including the execution of his program), and then type / to 
have register N opened again. 

Example 



400/002066^ £ 

39?^£ 

3765 /012643 17 /001326 J; 

/001326 Jl 
0/001472 



Open and close register 400 

9 is illegal 

Open and close register 3765 and then 

open register 1 7 

Re-examine register 17 

Open register 
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3.3.1 .2 Close Register (J ) - Typing a carriage return ( ^ ) closes any open register. If a register is open and the user 
types k J the value k will be stored in the open register and the register will be closed. 

Example 

300/ 000206 ^1 Register 300 unchanged 

300/ 000206 3333 ^^ Register 300 changed 

/003333 ^4- Verifies contents of location 300 

0/001472 279?^ I Open register 0; Register is not changed 

If a register is open, typing another register-opening command will close it. 

Example 

300/003333 426/ 010000 Closes 300 and opens 426 



3.3.1.3 Close Register and Open Next (4) - The line feed (I) works the same as the carriage return (^ ) except that 
after modifying (optional) and closing the open register, the next sequential register is opened and its location and 
contents are printed. Note that on the 4K machine, location follows 7777. 



Example 



300/003333 1 26 4- ^ Change contents of location 300 to 1263 

00301/700301 ~ and open 301. 



Note that ODT types addresses as five digits and register contents as six digits with no leading zero suppression. 

3.3.1.4 Close Register and Open Previous (t) - The up arrow (t) acts Hke the line feed (I) except that the register 
previous to the currently open register is opened. 



Example 



30 /7003141 J i Open register 30. The t causes 

0027/700002 ODT to open register 27. 



3.3.1.5 Close Register and Interpret Contents as Address (H - The left arrow (^) closes (optionally modifies) the 
currently open register. It then interprets the contents of the register as a memory referencing instruction. ODT then 
opens the register referenced by the address portion of that instruction. The indirect bit is not tested so that if the 
register contained the instruction LAC* 200 the following would occur: 



326/220200^^ I Ignore the indirect bit and 

00200/nnnnnn" open register 200. 



3.3.1.6 Open AC and Link Register ($A) - Typing SA at any time opens and displays the register holding the current 
AC value. The value may be modified if desired. 
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Typing | opens the next register which holds the Link status in bit 17. This may also be modified. 

33 A J Display PI and API Status {$J) - Typing $J causes ODT to sample and print the current PI and API status 
registers. Since both of these may be running, the values may be constantly changing. 

Example 

Pl/nnnnnn J | 
API/nnnnnn JH 

The PI is sampled with an lORS instruction and the API is sampled with the RPL instruction. Definitions of the bits 
in these registers may be found in the PDP-15 Reference Manual. 



3.3.2 Execute Instruction k (k$X) 

The instruction k will be executed. The saved AC and Link are restored before execution and saved again after. As 
long as k is not a CAL, JMP or JMS, control will remain in ODT. On a JMS or CAL, control returns to ODT on the 
instruction following the JMS or CAL, even if control is transferred to a routine that normally contains a breakpoint. 
The JMP A instruction will be executed as though the command kSG were given, where k is address A. All other 
instructions, except for the DBR instruction and the multiply /divide instructions of the EAE class, may be executed 
in this manner. Note that a skip instruction that actually skips causes the current breakpoint return address to be 
incremented by one. 

ODT responds with ^4- as soon as the $X command is accepted. When ODT is ready to accept another command, it 
types another carriage return - line feed sequence. 

Example 



1 400 1 2$X J I User executes a DZM 1 2. 



3.3.3 Setting User Start Address 



3.3.3.1 Open User Start Address ($Z) - Typing $Z opens a register internal to ODT and types its contents. The user 
can then type the start address of his program followed by . Then the command $G (see Section 3.3.3.2) will 
transfer control to the address specified. (The initial content of the $Z register is unspecified.) 

Example 

SZOQOOOO 200^ I Set start address equal to 000200. 

3.3.3.2 Transfer to User Start Address or Address k ($G, k$G) - This command is used to start the user program at 
any location. The command k$G starts the program at location k. The command $G starts the program as specified 
by the $Z register. 
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The normal use of $G is to initially start the user program. If breakpoints have been specified, they are set before 
control goes to the user program. The AC and link are unspecified unless the user has used the $A command to set 
particular values. The AC and link may also be specified by executing AC modifying instructions with the $X 
command. The status of the PI and API are not altered by a $G command. 

Another use of $G is to restart the user program at any point after a breakpoint has been encountered. That is, 
instead of continuing after the breakpoint with a $C, the user can start at some other location by typing the $G 
command. The user's AC and link are restored for a $C command. Again, the PI and API are not disturbed. 



3.3.4 Using Breakpoints 

ODT allows the user to specify up to four breakpoints at selected locations in his program (except location 1). The 
breakpoint facility of ODT provides a means of suspending the program operation at any desired point and then 
examining the status of the program through the use of the other ODT commands. 

3.3.4.1 Setting Breakpoints (k$B, k$nB) - To set a breakpoint at location k, the user types kSnB, where n is 1, 2, 3, 
or 4. If breakpoint n is already set at some location, it is moved to location k. The command k$B will assume 
breakpoint 1. 

3.3.4.2 Removing Breakpoints {$nB, $B) - To remove breakpoint n, the user can type $nB where n is 1, 2, 3 or 4. 
To remove all breakpoints, the user can type $B. 



NOTE 

The above described commands do not immediately alter the breakpoints. 
The mechanism is set so that the desired changes occur at the next $G or $C 
command. 



Example 



$B J I Remove all breakpoints 

300$4B^ £ Set breakpoint 4 at location 300. 

1760$b5 I Set breakpoint 1 at location 1760. 



3.3.4.3 Continue from Breakpoint ($C, k$C) - The $C command causes the user's instruction at the breakpoint to 
be executed and control to be returned to the user program. The k$C command does the same thing except that a 
loop count is set so that the break does not occur until the kth time it is encountered. This command may be given 
only while a breakpoint is in progress. Note that even though the loop count may not be satisfied, ODT is still entered 
and has control for about 200 ixs on every pass through the breakpoint. During this time, re-entrancy may occur (see 
paragraph 3.3.4,9). Note that $C is the same as 1 $C. 

3.3.4.4 Kill PI and API During Breaks ($K) - Typing $K causes the PI and API to be disabled during all breakpoints. 
Their status is saved and restored at the $C command. The SK command stays in effect until the $U command is 
given. 
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3.3.4.5 Allow PI and API During Breaks ($U) - Typing $U re-enables the PI and API after having been disabled by 
the $K command. This is the normal operating mode for ODT. 



3.3.4.6 Vary Autoindex ($V) - The operation of breakpoints requires the use of one autoindex register. The user 
may not use this register if ODT is used. Normally, ODT uses location 17 but the user may change this with the $V 
command. Typing $V opens a register internal to ODT, which holds the address of the autoindex register. The user 
may alter this value to any number in the range 10 through 17. This alteration, if performed, should be accompHshed 
before the first $G command is given to ODT. The user should also note that the autoindex register is used by ODT 
even if breakpoints are not specified. Starting ODT at location %ODT will reset the autoindex location to 17. 
Restarting ODT at %REST will leave the autoindex specification unaltered. 



3.3.4.7 Open Re-entrant PC List ($Y) - This command, which is really only meaningful after a re-entrancy error, 
opens the first breakpoint return address. Typing i opens the succeeding PC values. The list is terminated by an lOT 
class instruction (op code 70). Note that the values in this list are the addresses + 1 of the active breakpoints. 

3.3.4.8 Breakpoint Operation - When, during execution, the user program encounters the location of the breakpoint, 
control is transferred immediately to ODT. ODT saves the user program AC and hnk. The status of the teleprinter flag 
is also saved. From this point on, until a $G or $C command is given, the user does not have control of the Teletype. 
ODT then replaces all break instructions and types the breakpoint number and location as follows: 

^;$BnAk^| 

where n is the breakpoint number and k is the address of the breakpoint. 

ODT is now in control and is waiting for the user to type commands. The user can examine and change any registers. 
The current AC and link may be examined and modified by using the $A command. The user should note that the 
instruction at the breakpoint has not been executed. It will not be executed until a $C command is given. The user 
can remove and/or move any breakpoints at this time. 

At a breakpoint, while ODT has control, the status of the PI and API is not altered (except for short periods of time 
as described below). Thus, a breakpoint at priority n causes ODT to be entered and executed at that priority. This 
means all processing at that priority level and below will stop. 

However, all processing at priority levels above the level of the breakpoint will continue. It may be that the user will 
want all processing to stop at a breakpoint. This may be accomplished in two ways. The user may set the breakpoint 
in a section of code that is executed at the highest priority. If this cannot be done, the user can type the command $K 
to "kill" PI and API processing at the next breakpoint. The PI and API status is saved and then restored on the $C 
command. The $K command can be typed at any time that ODT has control; it stays in effect until the $U command 
is typed and vice versa. 

3.3.4.9 Breakpoint Restrictions - The following restrictions apply when using breakpoints: 
a. Breakpoints may not be placed at the following types of instructions: 
(1) Instructions that are modified by the user program. 
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(2) Instructions that are executed out of line by an XCT. 

(3) Instructions or data that are not actually executed, such as instructions used as arguments following a 
JMS. 

(4) An instruction that uses indirect addressing and is the first indirect following a DBR instruction. 
Breakpoints on other indirect instructions are not restricted. 

(5) An instruction in an area operating in the extend mode. 

(6) On any of the exit sequence instructions of a PI or API routine. For example, a breakpoint must not be 
set on any of the instructions . 

ION 
DBR 
JMP* 

in the exit of a PI routine. 

b. If a breakpoint is placed on a CAL instruction, the breakpoint will occur as normal. However, when the $C 
command is given, the breakpoint will be removed before control returns to the user. Thus, a breakpoint on a CAL 
instruction may only be executed once. A breakpoint may be set on any of the other memory referencing instructions 
(op codes 04 through 60), any operate instruction (op code 74), and the EAE instructions (op code 64). The lOT 
instructions are discussed in the next paragraph. 

c. There is one lOT class instruction that cannot be at a location where a breakpoint is set; this is the DBR 
instruction. Generally, this instruction requires that it be followed by a JMP* referencing the location holding the PC, 
link and extend mode status. This will not occur if the DBR instruction is at the breakpoint, since many ODT 
instructions will be executed after the DBR is executed and before the user regains control. 

If the $K command is in effect, breakpoints should not be set at the lOT instructions Hsted below. If a breakpoint is 
set at these instructions, the results will be as indicated. 

lORS The PI bit will always indicate that the PI is disabled. 

lOF No operation 



ION 



Could cause ODT to fail if any breakpoints are defined within an 
interrupt routine. 



SPI SPI will operate correctly if the API was off when the break was 

executed; however, if the API was enabled, then ODT raises the priority 
to level (highest priority). This may cause SPI not to skip when the 
user expects it to do so. 

ISA If the API was disabled when the break was executed and if the ISA is 

enabling the API, ODT may fail if any breakpoints are defined within 
the API level routines. If the API was enabled when the break was 
executed, then the API will be enabled and active at level when the 
ISA is executed. ODT will then DBK. Thus, if the user's ISA has 
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requested an interrupt at levels 4-7, the ISA will work. If the ISA has 
turned off the API, the ISA will operate correctly. But if the ISA has 
tried to raise the priority to levels 1-7, the ISA will operate as a no-op. 

^PL If the API was off when the break was executed, RPL will work. 

Otherwise, RPL will read a word into the AC which indicates that the 
API is enabled and level is active. 

d. There are several timing considerations for setting breakpoint instructions. 

(1) If the user is operating with no PI or API, then setting a breakpoint merely stops his program. Hence, 
all I/O in progress will be terminated until the $C command is given. 

If a XX$C command is given, the breakpoint is not executed again until the XXth occurence. The user 
must reahze that on every pass over the breakpoint, ODT is entered, the user instruction is executed by 
ODT, and then control is returned to the user program. Therefore, the instruction at the breakpoint, 
which normally takes from 1.5 to 1 2 jLis to execute, will actually take about 200 jus to execute. 

(2) If the use is running with PI and API enabled, then several additional timing restrictions must be 
considered. 

(a.) Assume the user inserts breaks only at the program level (that is, at non-PI, API levels). When a 
breakpoint is encountered, independent of the status of the iteration loop count, the PI is 
disabled for short periods of less than 80 jus and the API is temporarily raised to level (highest 
priority) for periods of less than 50 jus. 

(b.) Assume that the user inserts multiple breakpoints on the same priority level. When the breakpoint 
is encountered at level n, ODT will operate at that level (except for the short intervals, described 
in paragraph (2) (a) above where ODT operates at level 0). Therefore as long as the break is in 
progress, which could be several minutes, all interrupts on that priority and below will be 
inhibited. 

(c.) Several possibilities exist if the user places breakpoints on more than one level. In general, ODT is 
designed such that only one breakpoint may be in progress at any given time. However, it is 
possible that a breakpoint is executed at level N and then, before ODT can remove the other 
breakpoints, another breakpoint is encountered at a level M, where M has a higher priority than 
level N. ODT always detects this situation, but there is no way to recover to the extent that the 
user can continue his program. However, ODT will do the following: 

Disable PI, API 

Print the message ODT REENTERED 
Halt 

The user may press CONTINUE to restart ODT or he may manually restart ODT at location 
%REST (16011 on the distributed version). Thus, the user may examine, with ODT commands, 
the status of the program. In particular, he may use the $Y (see below) command to open up the 
first location of list of PC values of all breakpoints which are now active. By stepping down the 
list, he may determine which breaks occurred and in which order. The list may have from two to 
four entries, but is terminated with an lOT class instruction (op code 70). At first glance, it may 
appear that if a break is in progress, then the next break which interrupts the currently active 
break will cause ODT to terminate. However, the following may occur: 
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A breakpoint instruction is executed at some level. This saves the PC (return address v^hich is 
the breakpoint address +1). 

A higher priority level becomes active and takes control away from ODT, possibly before 
ODT can even save the AC. Of course, this may occur at any time before ODT removes the 
other breakpoints. 

Another break is executed on the higher level. This instruction will save the PC in the 
location following the PC of the interrupted breakpoint. If this breakpoint routine (in ODT) 
executes one more instruction, then ODT will detect the re-entrancy and the re-entrant error 
process will be initiated. However, this second breakpoint may be interrupted by a higher 
level request before it executes its first instruction (following the breakpoint instruction). Of 
course, the higher level routine may contain another breakpoint; etc. 

In any case, the following can be guaranteed: 

In no case will the PC value of an executed breakpoint be lost. 

Since there are a maximum of four breakpoints, either some breakpoint will get far enough 
to detect the re-entrancy or the breakpoint at the highest level will be executed. This means 
all other breaks are locked out so that the re-entrancy will be detected. 

On multiple entries, all AC values after the first will be lost. The first AC may or may not be 
lost. 

Thus, in case of re-entrancy, ODT will not collapse and the user will be able to determine what 
happened. The user may not issue a $C command. The SG must be used to restart the program. 

3.3.5 Searching Operations 

ODT has the capability to search a specified area of memory for any bit configuration in any specified bit position. 
When a match is found, ODT types the location and the contents of the memory register. The search is performed 
between a low and high limit with the following algorithm: 

a. Get the memory word 

b. Mask with the search mask (see below) 

c. Compare with k from the k$W command 

d. If equal, print location address and unmasked contents. If not equal, go to next memory register. 
The following command sequence is used to set the mask, low limit, high limit, and initiate the search: 

$M Open mask register for modification 

I Open low limit register 

I Open high limit register 

kSW Search for k 
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The mask and limits must be set before the k$W command is given. Otherwise, whatever is in these locations will be 
used. 

Note that a core dump between the low and high limits is performed if the user specifies a mask of and then types 
0$W ($W is the same as a OSW). 

Example 

Suppose the user wants to locate all JMS instructions between location 200 and 1500. The command sequence would 
be as follows: 



$M 077336 7400001 J 
07745/00100 2004^ 
07746/007000 1 500 ^\_ 
lOOOOOSWj; 
00300/102030^1 
01476/126750^41 



User opens and changes the mask. 

The line feed on previous line opens low limit 

Opens and changes high limit. 

User types JMS op code and then 

ODT starts the search 

There are two JMS instructions 

JMS 2030 at location 300 and 

JMS* 6750 at location 1476. 



NOTE 



The address of low-limit and high-limit registers may vary depending upon 
the assembled version of ODT. 



3.3.6 Initialize Buffers ($1) 

This command is used to load a specified value into any contiguous block of memory. The user defines the block to 
be loaded by setting start and stop addresses into the low and high limits of the word search routine. This means the 
user must first open the mask with $M and then type a line feed (j) to open the low limit. Once the start and stop 
addresses have been set up, typing kSI causes the value k to be loaded into the buffer. Typing $1 is the same as typing 
0$L 



Example 



$M 74Q00Q O 
07745/000200 4334- J 
07746/007000 624^ | 
400000$! ^U 



User opens MASK and then types I to open low limit. Change to 433. 
Open high limit and change to 624. Fill buffer with 400000. 
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NOTE 

The address of low-limit and high-limit registers may vary depending upon 
the assembled version of ODT. 



3.3.7 Paper Tape Output 

The following paragraphs describe the ODT paper tape output commands. 

3.3,7.1 High-Speed/Low-Speed Punch Available ($H, $L) - Typing $H indicates to ODT that all punching is to be 
performed on the high-speed punch. Typing $L indicates to ODT that all punching is to be performed on the 
low-speed punch (ASR Teletype). Since the low-speed punch and the teleprinter are physically connected, the user 
always has the punch turned off until after a command to punch has been given to ODT. ODT halts to allow the user 
to turn the punch on and off at the correct times. The user operates the CONTINUE switch on the operator's console 
to resume ODT operations. 



3.3.7.2 Feed Leader {$F) - The $F command causes about 2 feet of leader to be punched either on the high- or 
low-speed punch (depending on whether $H or $L has been seen by ODT). For the low-speed punch, ODT halts to 
allow the user to turn on the punch. The user then operates the CONTINUE lever. When the punching is complete 
ODT halts again so that the punch may be turned off before the next command is typed. The punch must be off 
when the keyboard is used or else the commands will be punched as they are typed. The halts are not performed 
when the high-speed punch is used. 



NOTE 

The initiation of any punching permanently disables the PI and API. The 
user's program may not be continued with $C. The program must be 
restarted with a $G. 



3.3.7.3 Dump Block of Memory {kj ; k2 $D) — This command causes the dumping of all locations between kj and 
k2, inclusive. If the low-speed punch is used, halts occur before and after punching. If k2 is not specified, an error is 
assumed. 

All dumping is performed in the PDF- 15/ 10 Loader format (see Figure 3-1), The main feature is that noncontiguous 
blocks may be punched, each with a separate checksum. After the last block there is a special start block that tells the 
loader to stop loading and transfer control to a specified address. This terminal block is punched by using the k$T 
command. As many blocks as desired may be dumped before the k$T is issued. 



3.3.7.4 Terminate Punching (k$T) - The k$T command causes the terminal block (see paragraph 3.3.7.3) to be 
punched. If $T is typed, the loader halts when loading is complete. If k$T is typed, the loader gives control to 
location k when loading is completed. 
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3.4 OPERATING PROCEDURE 

This section contains paragraphs describing the ODT loading procedure, start-up procedure, conditional assembly, and 
error recovery. 



3.4.1 Loading Procedure 

ODT can be loaded in several different ways. Since the user will have the symbolic source tape of ODT, he may 
assemble it into any convenient, contiguous block of memory. The pseudo-op .LOC must be supplied by the user. 
ODT would not, in general, be assembled below location 101 ; ODT may not, under any circumstances, be assembled 
below location 21. ODT may either be assembled and loaded with the user program, or assembled separately and 
loaded with the user program. It could even be loaded after the user program has been running. ODT may be 
assembled in the .FULL mode if desired. 

ODT will also be supplied as a binary tape that can be loaded by the PDP-15/10 Loader. Assuming that the loader is 
already in memory, proceed as follows: 

Press lO RESET 

Set the Address switches to 7700 or 7720 (17700 or 17720, if 8K). Note that these two addresses are for the two 
versions of the Loaders; the first one for the low-speed and the second for the high-speed paper tape reader. 

Press START. ODT will be initiated automatically by the loader unless a checksum error occurs. The distributed 
binary version loads at location 6000 (16000 if 8K) and runs almost up to the PDP-15/10 Loader. The addresses for 
starting and restarting are: 



%ODT = 16000 
4K systems or 

%REST = 16011 



8K systems 



%ODT = 6000 
%REST =6011 

3.4.2 Start-Up Procedure 

Several start-up procedures may be used with ODT. The distributed binary version starts automatically when loaded. 
User-assembled versions are started in a manner dependent upon the .END statement used. The source tape will not 
have an .END statement. Instead, it will have the .EOT pseudo operation. When the .EOT is encountered the user 
may continue with another segment of his program or he may insert a segment consisting of the .END statement. In 
any case, the .END determines the start-up procedure as follows: 

.END %ODT - ODT will start automatically when the binary tape is loaded. 

.END X - The user program will start at location X when the binary tape is loaded. The user will have to manually 
give control to ODT at location %ODT. 

.END - The loader will halt when loading is complete. The user must manually start at %ODT when he is ready. 

If ODT is in control initially, the user program is initiated with the $G command. Normally, control will then stay 
in the user program until a breakpoint is executed. 

In general, when ODT is started manually, an 10 reset should be performed first. 



3-16(PartII) 



When ODT is initiated, it types ^ 14. to indicate that it is ready to accept commands. 

3.4.3 Conditional Assembly 

The ODT source program is designed such that certain features may be deleted under the control of assembly 
parameters. At assembly time, a parameter tape may be read before the ODT source tape in pass 1. This tape contains 
definitions of parameters that allow the user to generate a particular version of ODT. The parameter tape need not be 
read on pass 2; however, reading it on pass 2 will provide a Ust of all defined parameters for the assembly. 

A parameter is either "defined" or "undefined." Defined means that the parameter name appears in the Assembler 
symbol table. "Undefined" means that it does not appear in the symbol table. None of the parameters are defined in 
the ODT source code. If the source tape is assembled without a parameter tape, all of the parameters listed below will 
be undefined; thus a version with all features will be produced. To define a parameter, %%J for example, include the 
assignment statement 

on the parameter tape. The parameter tape should be terminated by the .EOT pseudo-op. A complete description of 
how to define a parameter is given in Paragraph 1.4.7. 

The following paragraphs list the parameters available for ODT and their effect. 

3.4.3.1 %%J - If undefined, the command $J (display PI and API status) is available. If defined, $J is not available, 
thus saving approximately 21 (IVj o) locations. 

3.4.3.2 %%X - If undefined, the $X (execute instruction k) command is available. If defined, the $X command is 
not available, thus saving about 46 (38i o) locations. 

3.4.3.3 %%IVIULD - If undefined, there is no restriction on setting a breakpoint at a multiply or divide EAE class 
instruction. However, if the user's PDP-15/10 does not have the EAE option or if the user does not want to set 
breakpoints at multiply or divide EAE instructions (the other EAE instructions are not restricted), then 25 (21io) 
locations may be saved by defining %%MULD 

3.4.3.4 %%WIVI - If undefined, the word searching commands $M, $W, and the $1 command are available. If defined, 
these commands are not available, thus saving about 54 (44io) locations. If the user defines %%WM, the utility 
program SCAN may be used to perform the word searching or scanning function. 

3.4.3.5 %%KU - If undefined, the commands $K and $U are available to control the PI and API at breakpoints. If 
defined, these commands are not available, saving about 23 (19i o) locations. In this case, $U is always in effect. 

3.4.3.6 %%DFT - If undefined, the commands SH, $L, $D, $F, and $T are available to dump segments of memory in 
the PDP-15/10 Loader format on either the high-speed ($H) or low-speed ($L) paper tape punches. If defined, these 
commands are not available, saving about 213 (139io) locations. When these commands are not available, dumping 
may be performed, in the HRI format, by the HRM Puncher utility program. 

3.4.3.7 %%V - This parameter controls the $V command for varying the autoindex number. If %%V is undefined, 
the $V command is available. But if %%OB (see below) is defined, ODT will not need an autoindex register and the 
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$V command will not be available even if %%V is undefined. If %%V is defined, then the $V command is not 
available. In this case, ODT assumes register 17*. If %%V is defined and %%OB is undefined, approximately 30 (24i o) 
locations are saved. But if %%0B is defined, these 30 locafions are included in the locations saved. 



3.4.3.8 %%0B - This parameter controls the number of breakpoints allowed in ODT. As described in the paragraph 
about the $B command (see paragraph 3.3.4.1), there are four breakpoints available. This is the case when %%0B is 
undefined. 

If %%OB is defined, there is only one breakpoint available. This has several consequences which are listed below. It is 
assumed that the reader is famihar with the description of the breakpoint commands and restrictions described in 
paragraph 3.3.4. 

a. The command SB removes the breakpoint. (If $nB is typed, ODT ignores the n). 

b. The command kSB sets the breakpoint at location k. If it was already set somewhere else, it is moved to 
location k. (If k$nB is typed, ODT ignores the n). 

c. When the breakpoint is encountered, the message printed is ''^| $B A kj |" where k is the address of the 
break. 

d. The re-entrancy problem does not exist when only one breakpoint is available. 

e. The command $Y (open re-entrant PC list) is not available. 

f. No autoindex register is used; thus, the command $V (vary autoindex) is not available. 

g. Approximately 2 1 4 ( 1 40i o ) locations are saved. 

3.4.3.9 %AUTOX - The default assumption is 17 for which autoindex register to use. The parameter %AUTOX may 
be defined to change the default assumption; that is, if %AUTOX is undefined, then register 17 is used unless changed 
by the $V command. If %AUTOX is defined as 

%AUTOX=XX 

where XX is an octal number in the range of 10-17, then the default assumption will be autoindex register XX. 

3.4.4 Error Recovery 

3.4.4.1 Runaway Program - If the user program does not execute a breakpoint, ODT will not regain control. The 
following sequence of operations may be performed to give ODT control: 

Depress PROGRAM STOP. 

Depress lO RESET 



*The assumed autoindex register may be changed by a parameter definition. (See %AUTOX) 
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Set the address of %REST in the Address switches (601 1 or 1601 1 on the distributed version). 
Depress START 

This will cause ODT to restore the breakpoint instructions and transfer control to the command decoder. The $G 
command must be used to start the user's program. 

3.4.4,2 Re-Entrancy - The problem of re-entrancy on breakpoints is discussed in Section 3.3.4.9. ODT always 
detects the re-entrancy and prints an error message. At this time the user cannot determine if the PI and/or API were 
enabled when the re-entrancy occurred. However, the other PI and API status bits may be examined with the $J 
command. The $Y command is used to open the first entry of a list of PC values with the following meanings: 

PCj = Adr + 1 of first breakpoint to occur 
PC2 = Adr + 1 of next breakpoint to occur 



PCj^ = Adr + 1 of nth breakpoint to occur (maximum of four) 
70XXXX = End of PC list 

After the first value has been printed (by the $Y), each successive value may be printed by using the i command. The 
end of the list is indicated by an lOT class instruction (70XXXX). 

After a re-entrancy error, the user must again specify all breakpoints before restarting his program with the %G 
command. 



3.4.4.3 Breakpoint Entry Error - In the event of a software error in the user program or in ODT, it is possible that 
control could come to ODT as though a breakpoint had been executed. ODT would not be able to determine which 
breakpoint was executed; ODT would, therefore, proceed as follows: 

Disable PI, API 

Print BAD BREAK ENTRY 

Halt 

ODT can be continued by pressing CONTINUE or by manually starting at location %REST. Since, after a software 
failure, the user program or ODT may be destroyed, the user should reload both his program and ODT. 

Another situation, which is not a software error but an operational error, will cause the above error procedure to 
occur. This is the execution of the instruction at the breakpoint address, out of line, with an XCT. If this is the case, 
reloading is not necessary but the user's program may be restarted only with the $G command. 

3.4.4.4 Command Error - If a command is illegal or contains illegal characters, ODT ignores the command and 
responds with ?J I. If, while typing a command, the user changes his mind, he can cause ODT to ignore the 
command in the following ways: 

Type an 8 or 9. 

Type two ALT MODEs (or two Ss) 
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Type CTRL 

Type an illegal command character (e.g., "E*'). 

3.5 ODT ASSEMBLY INSTRUCTIONS 

ODT will be delivered both as an object program tape and as a source tape. The object program tape is loaded and 
initiated at location %ODT (6000 for 4K and 1 6000 for 8K). This version includes all ODT commands defined in this 
manual. 

The source tape is provided to allow the user freedom to assemble ODT at different locations, in the .FULL or 
PDF- 15/ 10 Loader format, and with certain features and options deleted or changed. 

Paragraph 3.4.3 described all of the conditional features of ODT. The largest version of ODT (no parameters defined 
except possibly for %AUTOX) is approximately 950io locations. The smallest version (all parameters defined except 
possibly %AUTOX) is approximately 530i q locations. 

The source tape has no .LOC statement and does not have an ,END statement. If the user assembles ODT by itself a 
.LOG and .END must be provided on separate tapes (segmented source tapes are described in paragraph 1.4.2 (Part 
II)). The main reason for leaving off the .LOG and .END is to allow the user freedom to change the .LOG or .END or 
follow ODT with user programs without requiring an editing of the ODT source tape. 

The following shows the coding for the tapes necessary to assemble ODT at location 200 in the .FULL mode with 
automatic initiation and with the dumping and word searching commands deleted. 



Tape 1 



%%DFT =0^1 
%%WM =0^1 
H -EOT^I 



Tape 2 



^ .FULL J I 
-*| .LOG -^ 200^ ; 
.EOT ) i 

Tapes 3, 4, 5 

Supplied ODT source tape (segmented into three pieces). 



Tape 6 



-^ .END-^%ODT^ ; 



On pass 1 of the assembly, tapes I through 6 must be read by the Assembler. On successive passes, it is not necessary 
to include tape 1 ; however, doing so will cause the parameter assignments to appear on the assembly listing. All tapes 
other than the parameter tape must be read on all passes. 
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CHAPTER 4 
COMPACT UTILITY ROUTINES 



4.1 INTRODUCTION 

This section provides descriptions of all utility routines supplied with the PDP-15/10 COMPACT Software System. 
These routines include a FAST- 15 system for DECtape handling, a hardware readin mode (HRM) punch routine, 
paper- tape handling routines, Teletype I/O routines, an octal dump routine, and a scan routine used to search core 
memory. 



4.2 FAST- 15 



4.2.1 General Description 

FAST- 15 (Fast Acquisition of System Tape) is a loading system for use in the PDP-15/10 COMPACT Software 
System to retrieve frequently used programs from DECtape and to create system tapes. The main advantages of the 
system are speed and ease of access. 

The equipment required for use of FAST- 15 includes a basic PDP-15/10 with 4,096 words of core memory, one Type 
TC02 DECtape Control unit, and one Type TU55 DECtape Transport. 

The FAST- 15 system tape, as distributed by Digital Equipment Corporation, contains commonly used system 
programs such as the Symbolic Editor, the CAP- 15 Assembler, and ODT. Since these can be called from DECtape 
with only a small bootstrap, paper-tape handling is eliminated. This results not only in a significant time savings, but 
also in increased reliabiUty. FAST-15 is by no means restricted to systems programs; it can be employed very 
conveniently for frequently accessed user-created programs. This chapter contains complete directions for use of the 
FAST-15 system tape, as well as directions for adding user programs to the system. 



4.2.2 The FAST System 

The FAST System includes four programs: the FAST Loader, the High Writer, the Low Writer, and the Reader. 
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In normal use, once the FAST Loader and FAST Writer have prepared a DECtape for system use, only the FAST 
Reader need be used; this program is commonly designated FAST. 



4.2.2.1 FAST Loader - The FAST Loader writes a table of contents or directory onto block 1 of a certified 
DECtape. The directory consists of 18 three-word entries; one entry for each of the 18 accumulator (AC) switches. 
Each directory entry specifies three parameters for the program to be stored and retrieved, under the control of an 
AC switch, as follows: 

The first location in memory occupied by the program (load point), 

The number of locations allocated in memory, 

The starting location of the program. 



4.2,2.2 FAST Writer - The FAST Writer transfers a program from core memory to DECtape as specified by the table 
in the first DECtape block. Program selection is determined by the leftmost AC switch in the 1 position. The FAST 
Writer exists in both high and low versions. The high version, which occupies location 7600 - 1111^ , is normally used. 
However, it is permissable for programs read by the FAST Reader to overlay the first lOOg locations of the Reader 
(e.g., locations 7600 - 7677g ). So that such programs may be written on a FAST DECtape, a low version of the FAST 
writer, which occupies locations 100 - SOOg , is used. 



4.2.2.3 FAST Reader - The FAST Reader transfers a program from the DECtape to the computer memory in the 
locations specified by the table in the first DECtape block. Program selection is determined by the leftmost AC switch 
in the 1 position. 



4.2.3 The FAST Loader 

The FAST Loader writes a table of contents (directory) of predetermined programs onto the first block of certified 
DECtape. This table determines the order of programs on DECtape and can be modified by the user. This table, which 
is located at the end of the FAST Loader, contains the following information for all programs: 

Its first location in memory (load point). 
The total number of words to be loaded. 
Its starting address. 

One program or core image is assigned to each of the ISjo accumulator switches. To each switch, 32io DECtape 
blocks are assigned which allows 176008 words to be written and/or read. The number of blocks assigned to each 
switch is not variable, but the number of words read or written is variable. Switch 17 has 30i o blocks assigned. This 
allows 1 70008 words to be written instead of 176008 • 

To load the directory onto the first block of the DECtape, the user should first modify the table of contents in the 
FAST Loader as necessary. This is most conveniently done by using the Symbolic Editor and punching a revised 
source tape. Using the CAP-15 Assembler, prepare a binary object tape. Select the DECtape for unit l-WRITE. Load 
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the FAST Loader using the PDP-15/10 Loader; it will stop with all Is in the AC. Press CONTINUE to execute the 
writing of the directory on block 1. If an error occurs, the Loader will return to the beginning and halt with all Is in 
the AC; otherwise, it will halt with the AC clear (all Os). 



4.2.4 The FAST Writer 

This description assumes that the DECtape which is about to be prepared is ready; that is, the FAST Loader has been 
appropriately modified and the directory has been written onto block 1 of the DECtape. 

To transfer a program from memory to the DECtape: 

Load the program into memory. 

Place the desired DECtape on a transport and select unit 1 -WRITE. 

Press I/O RESET. 

Place the Writer in the paper tape reader, set the ADDRESS switches to 7600 (17600 for 8K systems), and press 
START*. The Writer will stop with all Is in the AC. 

Set the DATA (AC) switches to select the desired program. Selection is controlled by the leftmost switch that is 
up; all switches to the right of that one are ignored. (No switches up is equivalent to switch up). 

Press CONTINUE to execute the transfer. If no error occurs, the computer will halt with the AC clear. If an error 
occurs, the Writer will return to the beginning and stop with all Is in the AC, 

4.2.5 The FAST Reader 

The FAST Reader (commonly designated FAST) occupies memory locations 7600 - 77778 (17600- 177778 for 8K 
systems). FAST destroys the 663 locations immediately preceding the first location of FAST before the program is 
read from the DECtape. However, the program read-in may overlay all of these 663 locations. If several programs are 
to be loaded through repeated use of FAST, only the last program to be loaded may overlay the 66^ locations 
mentioned above since each call to FAST destroys these locations. 

4.2.5.1 Standard FAST System Tape - The FAST System DECtape (prepared for system program retrieval) 
distributed by Digital Equipment Corporation, allocates the first five DATA (AC) switches as follows: 

'-«**'"'>** Program 

Switch Up 

Symbolic Tape Editor 

1 CAP- 15 Assembler 

2 ODT (with all commands 

defined) 



*If the area of core to be written will overlay the Writer, then the user must read in the low version of the Writer and set the Address 
switches to lOOg. 
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Leftmost 
Switch Up Program 

3 Paper Tape Lister 

^ Paper Tape Duplicator 

The user can, however, prepare different system DECtapes and working program DECtapes by the method described 
in paragraphs 4.2.3, 4.2.4, and 4.2.6. 

All of the standard system programs as distributed by DEC are initiated automatically by FAST after they are loaded. 
All system programs, except for ODT, are not normally loaded into memory with user programs; thus, their memory 
requirements are of no concern. ODT is loaded with user programs. This program is an overlay of FAST*, and must 
be loaded by FAST after other programs have been loaded. The memory requirement for ODT is exactly the same as 
the object program distributed on paper tape. 



Program Load Address Start Address Size 

ODT 6000 6000 (%ODT) 1665 

6011 (%REST) 



4.2.5.2 The FAST Start - These instructions are for use with DECtapes (similar to the one distributed by DEC) that 
have been properly prepared. 

Place the FAST System DECtape on a transport and select unit 1 -WRITE LOCK. 

Assuming FAST is already in memory, set the ADDRESS switches to 7600 (17600 for 8K systems) and press 
START (this is known as FAST Start). The computer will halt with all Is in the AC. 

If FAST is not in memory, perform the following: 
Press I/O RESET. 

Place the FAST binary tape in the paper tape reader. 

Set the ADDRESS switches to 7600 (17600 for 8K systems j and press START. 

The computer will halt with all Is in the AC. 

Set the AC switches to select the program desired, according to the table of contents (written onto block 1 by the 
FAST loader) associated with the DECtape. 



*The first lOOg locations of FAST can be overlayed by a program read from DECtape. 
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Press CONTINUE. The DECtape will rewind to block 1 , search forward to the appropriate block, and transfer the 
program. If no error occurs, control will transfer to the start of the program. If an error occurs, the computer halts 
with all Is in the AC, Check for an incorrect setting of the DECtape switches. The DECtape status flags can be 
examined for possible malfunctions. 

If the program just loaded did not overlay any part of FAST, then FAST is ready for the procedure beginning with 
"Set the AC switches". However, if the program did overlay FAST, FAST must be reloaded. 



NOTE 



The program selected is determined by the leftmost AC switch that is up; the 
positions of other switches to the right are ignored by FAST. No switches up 
is equivalent to switch up. 



4.2.6 Example Writing A FAST System Tape 

This example shows how to add a program to the standard system DECtape. The program to be added uses 426 
locations beginning with location 2000. The start address is 2010. The binary tape is in the CAP-I5 Loader format. 



4.2.6.1 Preparing the Directory — The standard systems tape has a directory with five programs assigned to switches 
through 4. This example will use switch 5 for the new program. The directory may be changed in two ways. The 
best method is to edit the source tape of the FAST Loader and assemble the new FAST Loader as described in 
paragraph 4.2.3. This always generates a hard copy of the new directory. The other method, which may be faster but 
is prone to errors, is to load the FAST Loader into memory, manually alter the proper directory entries and then 
execute the FAST Loader. In any case, the first 6 entries in the directory are initially as follows: 



TABLE 
ZERO 



ONE 



TWO 



TABLE 

1 

7477 

22 

1 

7477 

22 

16000 

1700 

16000 



/DUMMY LOCATION 

/SWITCH 0: SYMBOLIC TAPE EDITOR 

/STARTING ADDRESS 

/SWITCH 1 PDP-15/10 ASSEMBLER 



/SWITCH 2 ODT- 15 
/OVERLAYS FAST 



THREE 



FOUR 



1000 

22 

1 

2000 

22 



/SWITCH 3 PAPER TAPE LISTER 



/SWITCH 4 PAPER TAPE DUPLICATOR 
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FIVE 1 /SWITCH 5 UNASSIGNED 

7477 

22 

The standard system programs will remain as they are. Therefore, the entries for switches through 4 need not be 
changed. The entry for switch 5 will be changed to 

FIVE 2000 /PROGRAM LOADED AT 2000 

426 /USES 426 WORDS 

2010 /INITIATE AT 2010 



When the directory has been properly prepared, it may be written on DECtape as described in paragraph 4.2.3. 

4.2.6.2 Writing the Program on DECtape - To add the program to the system DECtape, proceed as follows: 
Place the prepared DECtape on unit 1 - WRITE. 
Place the binary tape containing the program in the paper tape reader. 

Set the ADDRESS switches to 7720 (or 7700) and press 10 RESET and then START. 

Set the ADDRESS switches to 7600 (17600 for 8K systems), place the HRI tape for the FAST Writer in the paper 
tape reader, and press READIN. 

Set AC switch 5 up (all others down). 

Press CONTINUE. The DECtape will rewind to block 1 and then will search forward to the proper block and write 
out the program. 

If no errors occur, the Writer will halt with Os in the AC. If it halts with all Is, an error has occurred. The program 
will be written again if the user presses CONTINUE. 

When the DECtape stops and the program halts with the in the AC, the writing is complete. To check that the 
program may be read again, proceed as follows: 

Change the DECtape unit to unit 1 - WRITE LOCK. 

Load the FAST Reader by placing the tape in the paper tape reader. Set the Address switches to 7600 (17600 for 
8K systems) and press READIN. 



Set AC switch 5 up. Press CONTINUE to read the program. Control should be transferred to location 2010 when 
loading is complete. If an error occurs, the reader will halt with all Is in the AC. In this case, press CONTINUE to 
read program A again. 
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4.2.7 Assembling The High And Low Writers 

As mentioned previously, the FAST Writer exists in two versions. The high version occupies locations 7600 - 1111^ 
(17600 - Mills for 8K systems) and the low version occupies locations 100 - 2778 • There is only one source tape for 
the two versions of the Writer. The source code is conditionalized so that if the symbol LOW is defined, the low 
version is produced at assembly time; if undefined, the high version is produced. (See Part II, paragraph 1.4.7, for a 
complete description of conditional assemblies.) Thus, if the source tape is assembled by itself, the high version is 
produced since LOW is undefined. The low version is produced by preceding the source tape with a parameter tape 
containing the following two statements. 



LOW = Oj 



4.3 HRM PUNCHER 

4.3.1 General Description 

The Hardware Readin Mode (HRM) Puncher is a self-relocating dump program, written in CAP- 15 Assembly 
Language. It can be loaded by means of the PDP-15/10 hardware readin (HRI) facility (see PDP-15 Reference Manual) 
into any block of memory. Once loaded, the HRM Puncher relocates itself and punches out a block of contiguous 
memory locations, specified by the user, in the HRI format. The HRM Puncher operates anywhere in up to 8K of 
memory. 

4.3.2 Output Format 

Binary output is punched in the HRI format which consists of the data words followed by the hardware readin word. 

The data words correspond to consecutive memory words from the start address through the stop address. Each word 
is punched as three frames. Each frame has channel 8 punched and channel 7 not punched. Channels 1 through 6 
contain six bits of the data word. The three frames correspond to the memory word as follows: 



Frames 



1 





X X X X 


X X 


1 





X X X X 


X X 


1 





X X X X 


X X 



A A^ 



Bifs 0-5 
Bits 6-11 
Bits 12-17 



Channels 1 -6 
— Channel 7 not punched 
Channel 8 always punched 



Following all the data words is the HRI word which halts the processor. This word is different than the data words in 
that channel 7 of the third frame is punched. The HRI word is punched as follows: 
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• o«*«»oo 

• ooooooo 

• ••ooooo 



74 

00 > 740040 = HLT 

40 



The HRI reads this word and executes the instruction, i.e., the processor halts. 

4.3.3 Functional Description 

The HRM Puncher is self-relocating and self-initializing. It uses several locations external to itself. These are: 

Location 

Locations 7766-7777, see below; (17766-17777 for SK). 



The source tape may be assembled under the control of two parameters to get four versions of the HRM puncher. The 
parameters are defined (or left undefined) at assembly time by means of a parameter tape (See Paragraph 1.4.7). The 
parameters are: 



SLOW 



V2 



Defined for low-speed punch (ASR). 
Undefined for high-speed punch. 

Defined to punch leader/trailer. 
Undefined to punch no leader or trailer. 



The four versions are described below. The distributed object program, in the .FULL mode, is for the low-speed 
punch and produces leader/trailer. 



4.3.3.1 High-Speed Punch With No Leader/Trailer - For this version, both parameters are undefined. The leader and 
trailer should be provided manually. This version requires 738 locations for the puncher, plus locations and 
7770-7777 for pointers and temporary storage. 



4.3.3.2 High-Speed Punch With Leader/Trailer - This version is assembled with V2 defined and SLOW undefined. 
The memory requirements are llSg locations for the puncher and locations and 7766-7777. 



4.3.3.3 Low-Speed Punch (ASR) With No Leader/Trailer - This version is assembled with only SLOW defined. The 
memory requirements are 1028 locations for the puncher and locations and 7770-7777. The leader and trailer 
should be provided manually. 



4.3.3.4 Low-Speed Punch With Leader/Trailer - Both V2 and SLOW are defined to assemble this version. The 
memory requirements are 1248 locations for the puncher and locations and 7766-7777. 
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4.3.3.5 HRM Puncher - The HRM puncher is divided into two almost equal parts. The first part performs the 
relocation and initialization (which includes the reading of the switches to set the start and stop addresses for the 
dump). The second part performs the actual dumping process. 



4.3.4 Operating Procedure 

The following paragraphs contain procedures for loading and starting the HRM puncher. 

4.3.4.1 Loading Procedure - Proceed as follows to load the HRM puncher: 
Press 10 RESET. 

Place the HRM puncher in the reader. 

Set the address of where the HRM puncher is to be loaded in the ADDRESS switches. 

Press the READIN key. 

The load address must not be 0. The address must be selected so that the HRM puncher does not overlay locations 
7766-7777. The size of the puncher is defined for the various versions in Section 4.3.3. 

4.3.4.2 Start-up Procedure - The HRM puncher can be started and/or restarted at any time after it has been loaded. 
The procedure is: 

Manually generate leader if necessary. 

Press 10 RESET. 

Initiate at the selected load address by pressing START. The program will halt immediately. 

Load the start address for the dump into the AC switches. Press CONTINUE. The program will halt immediately. 

Load the stop address for the dump into the AC switches (this address must be greater than the start address). Press 
CONTINUE. 

When punching is complete, the program will halt. Manually generate the trailer if necessary. 

To repeat, or to punch out another area, repeat the procedure from the beginning. 

4.4 PAPER TAPE HANDLING ROUTINES 

4.4.1 Paper Tape Lister (PTLIST) 

The Paper Tape Lister (PTLIST) is used to read an ASCII-coded paper tape from either the high-speed or low-speed 
paper tape reader, and to provide a character-by-character listing on the Teletype. Carriage return and line feed 
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characters must be punched on the tape if these operations are to take place (they are not handled automatically by 
PTLIST). If a tab is encountered by PTLIST, it is converted to the appropriate number of spaces. Each tab stop is 
assumed to be every tenth print position. 

When the program has been loaded by the PDP-1 5/10 Loader, it will type the following message on the Teletype: 

PLEASE READY THE INPUT DEVICE AND SET THE AC SWITCH. 

If input is to be from the low-speed (ASR) paper-tape reader, the user should set the reader switch to the ON 
position, set the AC switches to 400000, and depress the CONTINUE switch to start the listing. The program enters a 
wait loop when the reader runs out of tape. Inserting more input will cause the reader to continue. Typing CTRL U 
will cause the program to terminate*. 

If input is to be from the high-speed paper tape reader, the user should set the AC switches to and depress the 
CONTINUE switch to start the listing. The Hsting will terminate when the reader runs out of tape. At termination, the 
program types whatever is left in the input buffer and halts at location 2 1 . Press CONTINUE to restart. 

4.4.2 Paper Tape Duplicator (PTDUP) 

The Paper Tape Duphcator (PTDUP) is used to duplicate and/or verify ASCII or binary paper tapes using the 
high-speed paper tape reader and punch. The program can also be used to punch a title on a tape that is being 
duplicated. 

After the program has been loaded using the PDP-1 5/ 10 Loader, it prints the following message: 

SWITCH? (M,V, or D) 

The user should type the letter of the function that he wishes to perform, as described in the following paragraphs. 



NOTE 

At the end of the job the program halts at location 21. Press CONTINUE to 
restart. 



M (Master Tape Duplicator) — This switch allows the user to type in a title and have that title punched in readable 
format preceding his duphcated tape. The following characters have a special meaning while typing in a title line. 

ASCII Character Action 

212 LINE FEED Punch a title line and return for more input 

2 1 5 CARRIAGE RETURN Punch a title line and return for more input. 

377 RUB OUT(S) Ignore the previous character(s) 



*CTRL U is formed by depressing the CTRL key while striking the U key. 
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ASCII Character Action 

375 ALT MODE Punch title line and begin duplicating the tape (acts like D switch after 

it punches the title). 

225 CTRL U Ignore whatever is typed on this line and begin to type a new line. 

D (Duplicate a Tape) - The following message is printed: 

PARITY 

The user should type Y if he wants even parity to be generated. Any other character will cause the paper tape image 
to be duplicated as is. If the high-speed reader runs out of tape, the program will terminate when it has completed 
punching the input buffer. 



NOTE 

The tape being duplicated must have at least one inch of trailer. The last ten 
frames are not duplicated. 

V (Verify a Tape) — A parity check is performed on each frame. Frames not having even parity cause PARITY 
ERROR to be printed. The program will stop with the reader positioned at one frame past the frame in error. 
Depressing CONTINUE will cause the program to continue verifying. 

At the end of duplication the input frame count and output frame count are printed in octal, as follows: 

INPUT FRAME COUNT xxxxxx 
OUTPUT FRAME COUNT xxxxxx 

If the input and output frame counts are unequal, an error has occurred. The user should then restart the job. 



NOTE 

If the punch runs out of tape, the programs halts with all Is in the AC. Refill 
the punch and continue. 



The following message is always printed when verification has been completed. 

PARITY ERROR = nnnnnn 
where nnnnnn indicates the number of error frames in octal. 

4.5 TELETYPE INPUT/OUTPUT ROUTINES 

The Teletype Input/Output routines include the Teletype I/O Conversion (TICTOC) and the Decimal and Octal Print 
packages. Each of the routines in these packages is described in the following paragraphs. Each package should be 
assembled along with the program with which it is to run. The Teletype must be initialized by the user program to 
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enable use of the Teletype I/O routines. This is accomplished by the statement TLS+10 at the beginning of the user 
program (see PDP-15 Reference Manual). 

4.5.1 Teletype I/O Conversion (TICTOC) Package 

The Teletype Input/Output Conversion (TICTOC) Package is used to convert 8-bit ASCII code to a 6-bit trimmed 
ASCII code, and vice versa. Formatting facihties are also available. Routines in the package fall into three main 
categories: input, output, and formatting. The routines in each of these categories are described in the following 
paragraphs, along with input and output formats and character sets. 

NOTE 

When using output and formatting routines, ensure that all characters have 
been printed before halting. This can be accomplished by means of the "skip 
if teleprinter flag set" instruction TSF (see PDP-1 5 Reference Manual). 



4.5.1.1 Input Routines - The input routines include %TIC and %TIC1. %TIC is used to input a string of characters 
from the Teletype and pack them three to a word into memory. The first, second, and third characters (in order of 
arrival) are packed into the left, middle, and right sections of a word. Subroutine %TIC requires two arguments for 
execution; the calHng sequence is as follows: 



foTIC 



(PC-1) 


LAW 


(Stop Character) 


(PC) 


JMS 


%TIC 


(PC+ 1) 


.DSA 


(Buffer Area) 


(PC + 2) 


(Return) 





Stop Character may be the trimmed ASCII (see Section 5. 1 .4) or 8-bit ASCII of any character. %TIC will only look at 
the rightmost six bits of the Stop Character. When this character is typed, %TIC stores it with the rest of the text and 
returns to the calling program at location (PC + 2). Buffer Area is the address of the first location of a block of 
storage into which the incoming text is to be packed. When the Stop Character (terminating character) is 
encountered, it is packed and the rest of the word filled out with zeros, if necessary. The user is not allowed to use 
the character @ as part of his text. 

Four teletype keys have special meaning for %TIC: 

LINE FEED (ASCII 212) - causes %TIC to ignore what has been typed and start over again. The input buffer 
address is reinitialized to receive the new text, and %TIC outputs a carriage-return and line feed to the Teletype. The 
tab count is set to 0. 

AT SIGN (@ ASCII 300) - delimits the text externally. The @ performs the same function as the Stop Character. 
The rightmost six bits are stored with the rest of the text and, if necessary, the word is filled out with zeros. Return is 
made to location PC + 2 of the calling program (see calling sequence). 

TAB KEY (ASCII 21 1) - TICTOC keeps a tab count. When the TAB key is struck, the Teletype spaces to the next 
TAB stop. The spaces are stored in the input buffer with only the rightmost six bits being packed. The tab count is 
then set to 0. 
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CARRIAGE RETURN (ASCII 215) - The tab count is cleared and a Teletype carriage return and line feed are 
executed. No data is packed and %TIC keeps listening, %TIC will not stop listening until either the Stop Character or 
an @ (at sign) has been typed. %TIC uses subroutine %TIC1 to get an 8-bit ASCII character. %TIC restores the AC and 
link before returning. Refer to Section 5.1.4 for list of valid %TIC characters. 



%TIC1 Calling sequence: 

(PC) JMS %TIC1 /Subroutine Call 

(PC + 1 ) (Return) /Return with 8-bit ASCII 

character in AC. 



Subroutine %TIC1 inputs a single 8-bit ASCII character from the Teletype. %TIC1 uses subroutine %TOCl to echo 
the character that was typed on the keyboard. 



4.5.1.2 Output Routines - The output routines include %TOC, %TOCl, and %TDIG. 

%TOC ~ Subroutine %TOC is used to type out a string of text in the same format as described for %TIC (three 
6-bit characters per word). Each 6-bit set is tested for being less than 408 ■ If the 6-bit set is less than 408 . then SOOg is 
added to it to form an 8-bit ASCII character. 2008 will be added to the 6-bit set if it is 408 or greater. When the 8-bit 
character has been built, %TOC will use subroutine %T0C1 to print it. The calling sequence is as follows; 



(PC-1) 


LAW 


(Stop Character) 


(PC) 


JMS 


%TOC 


(PC+ 1) 


.DSA 


(Buffer Address) 



(PC + 2) (Return) 

The AC and link are restored by subroutine %TOC. The buffer address is the address of the first word of the block of 
storage containing the text. The last character in the typing string is the Stop Character, which is not typed. As in 
%TIC, the rightmost six bits of the Stop Character are the only bits considered. If an at sign (@) is encountered, it will 
act as if it were the Stop Character. 

%T0C1 ~ Subroutine %T0C1 outputs an 8-bit ASCII character to the teleprinter. A tab count is kept by %T0C1 
which is used by subroutines %TABIT and %TIC. No assumption is made concerning the position of the teleprinter. 
%T0C1 types one character at the current position of the Teletype. The 8-bit character is not examined in any way 
before printing on the Teletype. The calhng sequence is as follows: 

(PC) JMS %TOC 1 /Call with 8-bit character 

in AC. 

(PC + 1 ) (Return) /Return with AC and link 

unchanged. 

%TDIG Subroutine %TDIG is used to type a single digit. The calling sequence is as follows: 
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(PC) JMS %TDIG /AC must already be loaded. 

(PC + 1 ) (Return) /AC and link unchanged. 

The AC must be set before calling %TDIG. The leftmost fourteen bits are stripped from the AC. The four bits left are 
added to 2608 to form an 8-bit ASCII character. %TDIG uses subroutine %TOC 1 to print the character. 

4.5.1.3 Formatting Routines - The formatting routines include %CARR, %TABIT, and %SPACE. The calling 
sequence and description of each routine follows. 

%CARR - Calling sequence: 

(PC) JMS %CARR /Subroutine call 

(PC+1) (Return) 
A carriage return (ASCII 215) and line feed (ASCII 212) are printed. The tab count is then set to 0. 
%TABIT — Calling sequence: 

(PC) JMS %TABIT /Subroutine call 

(PC+1) (Return) 

The Teletype spaces to the next tab stop. The tab count is then set to 0, This count is kept automatically. %TIOCN, 
the number of spaces in a tab, is normally assembled as 8 (decimal), but may be altered by the user. 

foSPACE ~ Calling sequence; 

(PC) JMS %SPACE /Subroutine call 

(PC+1) (Return) 

A space (ASCII 240) is printed on the Teletype. The accumulator and link are unchanged by calling the formatting 
routines. 



4.5.1.4 Input Format and Character Set - The input characters read from the Teletype buffer by %TIC1 and %TIC 
are 8-bit ASCII. They are converted to 6-bit ASCII by stripping off the high-order 2-bits. The character set is as shown 
in Appendix I. 



4.5.1.5 Output Format and Character Set - The 6-bit code is expanded to 8-bit ASCII by adding 2008 or SOOg to it. 
If the 6-bit number is less than 408 , ^OOg is added; otherwise, 2008 is added (see Appendix A). 

4.5.2 Decimal And Octal Print Package 

The Decimal and Octal Print Routines (%DIP, %OPT, %OPS, and %OPZ) are subroutines which dump the 
accumulator in either signed-decimal or octal mode. 
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4.5.2.1 Decimal Integer Print (%DIP) - This routine prints the signed decimal equivalent of an 18-bit binary number. 
The binary number to be printed must be loaded into the AC before calling %DIP. Insignificant Os (leading Os) are not 
printed; the routine types a space in place of each leading zero. In the case of a negative number, before typing the 
first significant figure, the routine types a minus sign. If the number is positive, the sign is omitted (space) and 
understood to be plus. 

4.5.2.2 Octal Print Subroutines {%OPS, %OPT; %OPZ) ~~ The Octal Print subroutines type the contents of the 
accumulator as an octal number, suppressing nonsignificant leading zeros if desired. Two methods of suppression are 
available through two entry points. 

a. %OPS - The (JMS %OPS) entry causes leading zeros to be suppressed; the printed number occupying only the 
number of spaces needed to print all significant digits (left justified). 

b. %OPT - The (JMS %OPT) entry causes leading zeros to be suppressed by blanks; the printed number is right 
justified in six spaces. 

c. %OPZ - The (JMS %OPZ) entry causes no zero suppression to take place. 

4.5.2.3 Operation - Input to the subroutines is provided in the accumulator by the user. 
The subroutines are called directly: 

(PC-1) LAC NUM 

(PC) JMS %DIP/%OPZ/%OPS/%OPT 

(PC + 1 ) (Return) 

Control is returned to the user at location PC + 1 . 

The Hnk and AC are restored upon return to the calhng program. 

The character set for the decimal and octal print routines is as follows. 

%DIP: -,0,l,..9,Space 

%OPS/%OPT 0,l,...7,Space 

%OPZ:0,1,..7 



Examples 



Input (AC) 

mill 

311111 
400000 



%DIP 



131071 
131072 



%OPT 

mill 

311111 
400000 



%OPZ 

mill 

311111 
400000 



%OPS 

mm 

311111 
400000 
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Input (AC) 


%DIP 


%OPT 


%OPZ 


%OPS 


000000 








000000 





400055 


-131027 


400055 


400055 


400055 


000055 


45 


55 


000055 


55 


4.6 OCTAL DUMP ROUTINE 











4.6.1 General Description 

The Octal Dump Program allows the user to obtain either Teletype hard copy or paper tape output showing the 
contents of any register or set for registers that he specifies. The user specifies which registers are to be dumped via 
the Teletype keyboard as described in the following paragraph. 



4.6.2 Input Format And Character Set 

To obtain the dump of all memory locations between registers A (represented by xxx..) and B (represented by yyy..) 
where A < B, the user must type xxx..-yyy..-. A minus sign must be placed after each address; there is no need to type 
leading zeros in the address. 

Examples 

To dump from lOg to 258 ^ type: 10-25- 

To dump from lOOg to 13778, type: 100-1377- 
To obtain the contents of a single register, type the address twice, followed by a minus sign each time, as usual. 
Examples 

To obtain 10, type: 10-10- 

To obtain 7725, type: 7725-7725- 

To obtain the contents of all registers from address A up to the end of memory (7777 in a 4K machine, 17777 in an 
8K machine) type address A followed by a slash. 



Example 



1500/ 



To print out memory locations between two registers A and B, type the smallest register first and the largest second, 
each followed by a minus sign. 



Example 



If A <B, type: A-B 
If A >B, type: B-A 
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If the user types 6 characters and the sixth character is not a slash (/), or minus (-) the program will interpret this as 
an illegal character. The highest possible address is 1111^ (or \1111^ for an 8K machine). 

Always place a minus sign after each address. If an illegal (not octal) character is typed, the program does not 
recognize it and types back a question mark (?) followed by a carriage return and line feed. 

The input character set includes the numbers 0,1,. ..7, and the special characters / and -. 



4.6.3 Output Format And Character Set 

The output format appears as follows 

LLLLL xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx 
LLLLL xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx 



where the LLLLLs represent a five-character octal address in increments of lOg, and the xxxxxx's represent the 
contents (in octal) of locations LLLLL to LLLLL + 7g . 

Example 

00100 123014 530126 430765 110476 104572 271246 312467 764213 

00110 453123 693530 511430 610110 222104 631221 745311 113457 
If all locations in any hne or group of lines of at least lOg locations are equal, the output would appear as follows. 

00120 123456 711111 740040 000000 000000 123123 740040 740040 
740040 omitted 

00160 740040 740040 740040 740040 740040 123123 600000 000000 
The output character set includes only the digits through 78 . 

4.6.4 Operation 

DUMP is normally loaded starting at location 7300 (17300 for an 8K machine). The user can change this starting 
address by reassembling the DUMP program, preceded by a strip tape. The strip tape satisfies conditional assembly 
statements in the DUMP program by defining a start address. This is accompHshed by setting the symbol LOW to the 
desired starting address. 

Example 

LOW =22^ 

H .EOT^ 
(DUMP program follows) 
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The above example would cause the DUMP program to be assembled starting at location 22. If the symbol LOW is not 
defined, the default start address is location 7300 (17300 for an 8K machine). 

After loading the program starts automatically. It types a carriage return/line feed and prints the following message: 
OUTPUT DEVICE = 

The user must respond with H if the output is to go to the high-speed paper tape punch. Any other character will 
cause the program to assume the teleprinter as the output device. The program then outputs a carriage return/line 
feed and goes into a wait loop. The user should then type his parameters. 

After the user's parameters have been satisfied, the program restarts automatically with a carriage return/line feed and 
waits for more parameters. If the user wishes to change the output device, he must restart the DUMP program at the 
original start address. 



4.7 SCAN ROUTINE 



4.7.1 General Description 



SCAN is a small (lOOg locations) program used to scan areas of memory for a particular bit configuration. The user 
specifies the start and stop address for the area to be scanned, the bit configuration to look for, and the bit positions 
to be tested (e.g., a mask). SCAN then scans the area. When a match is found, the address of the match is printed 
along with the unmasked matching word. Proper selection of the operating parameters allows SCAN to be used as a 
dump. SCAN operates in either 4K or 8K without reassembly. 



4.7.2 Output Format 

The output of SCAN is a sequence of addresses and their contents printed on the Teletype. When SCAN is initiated, it 
prints a carriage return (J ) and a line feed (i). As matches are found, the addresses and contents are printed as: 

AAAAA/XXXXXX J I 

where AAAAA is the address (5 octal digits) and XXXXXX is the unmasked contents (6 octal digits). After the last 
hne has been printed, another carriage return/line feed sequence is printed and SCAN halts. 

Example 

The following is an example of a SCAN output to search an area for all JMS instructions: 

Rennarks 

00200/ 1 00600 ^ i JMS 600 at location 200. 
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Remarks (cont) 

00377/1 00670 >i?; JMS 670 at location 377. 

^; END of SCAN. 

4.7.3 Functional Description 

SCAN is a self-contained and self-initializing program. Once loaded, it may be started and restarted at any time. SCAN 
never alters any locations outside of itself. SCAN consists of a main program and three subroutines. The actual scan is 
accomplished by the main program. All output is performed by the three closed subroutines. The SCAN process is 
performed for all locations between the beginning address and the end address as follows: 

Fetch the contents of the core location. 

Mask* it with the contents of MASK (specified by user). 

Compare the result with the contents of WORD (specified by user). 

If not equal, repeat for next core location. If the compare is equal, print the address and the unmasked 
contents. 

In general, SCAN operates at I/O speed. If no matches are detected, a 4K area is scanned in the time it takes to print 
two carriage return/line feed sequences. 

SCAN may be used as a dump or as a search for any particular bit configurations. For example, the user may: 

Locate all instructions with a particular op code (such as all JMSs or all XCTs). 

Locate all references to a particular address. 

Locate all indirect references. 

4.7.4 Operating Procedure 

The following paragraphs describe the loading procedure and start-up procedure for the SCAN program. 

4.7.4.1 Loading Procedure - SCAN is loaded by the hardware readin (HRI) facility of the PDP-15/10. The procedure 
is as follows. 

Load the paper tape into the reader. 

Set the address of BEGIN in the Address switches. This address is 7700 (17700 for 8K) on the supplied binary 
tape. 

Depress the 10 RESET key. 



*"Mask" indicates an 18-bit Boolean AND function. 
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Depress the READIN key. 
When loading is complete, the processor will halt. 

4.7.4,2 Start-Up Procedure - The following procedure can be used at any time to start or restart SCAN. The purpose 
of this process is to set four parameters for SCAN, These are, in the order that they are set: 



Location 




4K 8K 




7701 17701 


WORD 


7702 17702 


MASK 


7703 17703 


BEGLOC 


7704 17704 


ENDLOC 



/Bit configuration to look for. 
/Specifies which bits to test. 
/(I to test, a to not test.) 
/First location to test. 
/Last location to test. 

Initially, the first three values are and the last is 7777. Once a value has been set, it does not have to be set again for 
another run if it is desired to use the same value again. 

The Start-up procedure is as follows: 
Press 10 RESET key. 

Set the beginning address of SCAN into the ADDRESS switches. This is 7700 for 4K or 17700 for 8K. 
Press EXAMINE to store the address in the AR register. 

Set the desired value for WORD into the AC switches. Operate the DEPOSIT NEXT key. This sets the value from 
the AC switches into memory. 



NOTE 

If it is not desired to change the present value of the parameter, step d may 
be replaced with the operation EXAMINE NEXT. 



Repeat the preceding step for MASK, BEGLOC, and ENDLOC. 

Operate the START key. This starts SCAN at location BEGIN. 

To search for all references to 7200 between locations 500 and 1 500: 



(WORD) = 7200 
(MASK) = 7777 
(BEGLOC) = 500 
(ENDLOC) = 1500 
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To dump all of the area between the BEGLOC and ENDLOC, specify WORD = and MASK = 0. This causes a match, 
and associated printout, to occur at every location. 

If a restart is desired and no parameters are to be set, only the first three steps and the sixth step need be performed. 
After the first three steps have been performed, the sixth step may be performed at any time to start the program. 
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CHAPTER 5 
COMPACT MATHEMATICAL ROUTINES 



5-1 INTRODUCTION 

All mathematical routines in the PDP-15/10 COMPACT Software System library are described in this section. These 
routines are grouped in four major packages: Integer Arithmetic, Trigonometric Functions, Floating Point, and 
Floating Point I/O. Table 5-1 on page 5-19 provides a concise listing of their important characteristics. Each package, 
if used, must be assembled and loaded with the user program. The size and number of tapes furnished for each 
package are as follows. 



Package 


Size (decimal) 


Number of Tapes 


Integer Arithmetic 


184 


4 


Trigonometric Functions 


760 


2 


Floating Point 


574 


1 


Floating Point I/O 


4ao 


1 



Separate tapes are supplied for each of the four Integer Arithmetic routines. Trigonometric Functions are on two 
tapes - one single precision and one double precision. Each of the above tapes is terminated with a .EOT pseudo-op. 
All symbols that are internal to the math routines begin with a percent sign (%) so that the user can avoid using them 
as his own symbols. 

If any of the trigonometric functions are not required by a user program, the user can specify that they are not to be 
assembled by means of a strip tape. The strip tape contains symbols that are used in conditional assembly statements, 
and is ended with a .EOT pseudo-op. This procedure can save a great deal of core space, and symbol table space, for 
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users who do not require all of the trigonometric functions. The following symbols (set equal to 0) should be included 
on the strip tape, as desired, to specify that a function should not be assembled. 



Single-Precision Functions 



POLY 



32 



Function 


Size (decimal) 


Symbol 


SQRT 


34 


%NSQRT 


SIN 
COS 

%SIN (internal routine) 


7 
11 

55 


%NSIN 
%NCOS 
(both of the above) 


EXP 


69 


%NEXP 


ALOG 

ALOG 10 

%LOGS (internal routine) 


11 
11 
51 


%NALOG 

%NLG10 

(both of the above) 


ATAN 


50 


%NATAN 


TANK 


33 


%NTANH 



%NPOLY 



Double Precision Functions 



DSQRT 


35 


DSIN 


7 


DCOS 


12 


%DSIN (internal routine) 


69 


DEXP 


86 


DLOG 


12 


DLOG 10 


12 


%DLOGS (internal routine) 


59 



DATAN 
DPOLY 



90 



35 



%NDSQ 

%NDSIN 
%NDCOS 
(both of the above) 

%NDEXP 

%NDLG 

%NDL10 

(both of the above) 

%NDTAN 

%NDPOL 



For example, if a user program did not requhe the functions SQRT, TANH, and ALOG 10, and wished to conserve 
core space, he would assemble a strip tape containing the following symbols before assembling his own program and 
the trigonometric functions. 

%NSQRT=0 J 

%NTANH=0^ 
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%NLG10=0^ 

H-EOT^ 

Assuming that the double-precision trigonometric functions were not required, the following functions would then be 
assembled. 

SIN 

COS 

%SIN 

EXP 

ALOG 

%LOGS 

ATAN 

POLY 

The same procedure applies to the Floating Point Package and to Floating Point I/O. Both the single precision and 
double precision sections of the Floating Point Package require that the general floating point section be assembled 
with them. However, if either the single precision or double precision section of the Floating Point Package is not 
required by a user program, the user can delete them by including the symbols %NSING or %NDOUB on the strip 
tape. In like manner, if either the floating point input (FLIP) program or the floating point output (FLOP) program is 
not required in the Floating Point I/O Package, the symbols %NFLIP or %NFLOP, respectively, should be included on 
the strip tape. 



5.2 INTEGER ARITHMETJCSIIVrULATION 

The Integer Arithmetic Simulation routines include multiply (MULT), logical multiply (LMUL), divide (DIV), and 
logical divide (LDIV). The purpose of these routines is to allow PDP-15/10 users to program using simulated multiply 
and divide instructions. A description of each routine is given in the following paragraphs. The reader is referred to 
Table 5-1 (Page 5-19) for a tabular summary of all COMPACT mathematical routines. Included in the summary for 
each routine is the name, mnemonic, calling sequence, function, errors, accuracy, timing, storage requirements, and 
pertinent comments. 



5.2.1 Multiply Routines (MULT/LMUL) 

The purpose of MULT is to multiply a signed 18-bit multiplicand by a signed 18-bit multiplier and produce a signed 
36-bit product. Return is made with the low-order product in the AC and the high-order product in location 
%MHIGH. 
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The purpose of LMUL is to multiply a logical (unsigned) 18-bit multiplicand by a logical 18-bit multiplier and 
produce a logical 36-bit product. Return is made to the calling program with the low-order product in the AC and the 
high-order product in location %LMHY. 



The calhng sequence for the multiply routines is as follows. 
PC-1 LAC 

PC JMS 



Multiplier 
MULT (or LMUL) 



PC+1 
PC+2 



LAC 
(Return) 



Multiplicand 



The algorithm used by the multiply routines is as follows: the least significant bit of the multiplier is tested; if it is 
equal to 1, the multiphcand is added to the developing product, which is then shifted right one bit position; if it 
equals 0, no addition is made before the shift. The process is repeated until all the bits of the multiplier, in order from 
least significant to most significant, have been processed. 



Example 

For this example, assume that register MPl is the multiplier, MP2 is the multiphcand, and that the product will be 
developed in registers MP3 and MPl, combined. Each of these registers is 5 bits long for purposes of illustration. The 
multiplier (MPl) is equal to 9, and the multiplicand (MP2) is equal to 4. 



MPS 


MPl 


MP2 


Comments 


00000 


01001 


00100 


Initial state of registers. The least significant bit of MPl is tested. 


00100 
00010 


01001 
00100 


00100 
00100 


Since it is a 1 , the contents of MP2 are added to MP3. 

The combined contents of MP3 and MPl are shifted right one position. The least 
significant bit of MPl is tested. 


00001 


00010 


00100 


Since it is a 0, no addition takes place, the combined contents of MPS and MPl are 
shifted right one position, and the least significant bit of MPl is tested again. 


00000 


10001 


00100 


Since it is a 0, no addition takes place, the combined contents of MPS and MPl are 
shifted right one position, and the least significant bit of MPl is tested again. 


00100 
00010 


10001 
01000 


00100 
00100 


Since it is a 1 , the contents of MP2 are added to the contents of MPS. 

The combined contents of MPS and MPl are shifted right one position and the 
least significant bit of MPl is tested again. 


00001 


00100 


00100 


Since it is a 0, no addition takes place, the combined contents of MPS and MPl are 
shifted right one position, and the multiplication is complete (with a product of 36 
in locations MPS and MPl combined). 
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5.2.2 Divide Routines (DIV/LDIV) 

The purpose of DIV is to divide a signed 36-bit dividend by a signed 18-bit divisor. The signed 18-bit quotient that is 
developed is returned to the AC. The remainder, signed the same as the dividend, is returned in location %REM. When 
the magnitude of the divisor is equal to or less than that of the high-order dividend, no division takes place since the 
quotient cannot be expressed by an 18-bit signed integer. In this case, the program exits with the link bit set to 1. If 
division takes place, the link bit is set to prior to exit. 

The purpose of LDIV is to divide a logical (unsigned) 36-bit dividend by an unsigned 18-bit divisor. The 18-bit 
quotient that is developed is returned to the AC. The remainder is returned in location %LREM. When the high-order 
dividend is greater than or equal to the divisor, division does not take place, and the link bit is set to 1. If division 
takes place, the link bit is set to prior to exit. 



The calUng sequence for the divide routines is as follows. 
PC-1 LAC 



Dividend (high order) 



PC 

PC+1 
PC+2 



JMS 
LAC 
LAC 



DIV (or LDIV) 
Dividend (low order) 
Divisor 



PC+3 



(Return) 



The algorithm used by both division routines is binary long division, where the quotient is determined by a 
subtraction process. Unlike decimal long division, where a single quotient digit can be one of 10 numbers, in binary 
long division the quotient digit is either 1 or 0. To determine this digit, the divisor is subtracted from the dividend and 
if the remainder is negative, the quotient digit is 0, the remainder is ignored, the divisor is moved one place to the 
right with respect to the dividend, and the process is repeated. If the remainder is positive, the quotient is 1 and the 
remainder is used as the next dividend, as in ordinary long division. In either case, the divisor is moved one place to 
the right and the next bit from the original dividend is included with the new dividend. The following example 
demonstrates the algorithm. The divisor is equal to 5, and the dividend is equal to 458 . 



Example 



Step 1 







101 /lOOlOl 
101 
-111 



Result of division is negative; therefore, quotient is 0. 
Disregard remainder. Move divisor one place to right. 



Step 2 



01 
/lOOlOl 
101 
+ 100 



Result of division is positive; therefore, quotient is 1. Retain 
remainder as new dividend and bring down next digit from 
dividend. 
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Step 3 Oil Result of subtraction is positive; therefore, quotient is 1. 

101 / 100101 Retain remainder as new dividend and bring down next digit. 

101 



1000 
101 
+ 11 



Step 4 0111 Final quotient is 1 1 1 with a remainder of 010. 

101 /lOOlOl 
101 
1000 
101 
111 
101 
+010 



In implementing the algorithm, the divide routines rotate the dividend left instead of moving the divisor right. No 
division occurs if the high-order dividend is greater than or equal to the divisor. This eliminates situations where the 
high-order dividend is divisible by at least one (which, if allowed to continue, would produce erroneous results). 



NOTE 

DIV does not check for the overflow condition that will occur when the 
high-order dividend is zero, the low-order dividend is greater than 377777 
(bit zero is set), and the divisor is equal to 1. 

5.3 TRIGONOIVIETRIC FUNCTIONS 

Detailed algorithms for all trigonometric functions in the PDP- 15/10 COMPACT Software System Mathematical 
Library are described in this chapter. Most of the functions are computed by methods of approximation as described 
by Cecil Hastings in his book Approximation for Digital Computers, 

The trigonometric routines must be assembled along with the user program. The Floating Point Package (paragraph 
5.4) must also be assembled to enable use of the trigonometric routines. Execution time for the trigonometric 
routines is greatly reduced if the EAE option is available since multiplication and division can then be accompHshed 
by the hardware. 

The reader is referred to Table 5-1 for a tabular summary of all PDP- 15/ 10 mathematical routines. Included in the 
summary for each routine is the name, mnemonic, calling sequence, function, errors, accuracy, timing, and pertinent 
comments. 



5.3.1 Square Root (SORT, DSORT) 

The calling sequence for the square root routines is as follows. 

PC JMS SQRT (or DSQRT) 

5-6(Part II) 



PC+1 


.DSA 


PC+2 


(Error Return) 


PC+3 


(Normal Return) 



ARG (+400000 if indirect) 



If the argument (ARG) is negative, return is made to the error return (PC+2) with the argument in the floatir 
accumulator and the AC set equal to 1; otherwise, return is made to location PC+3 with the square root of th. 
argument in the floating accumulator. 

A first-guess approximation of the square root of the argument is obtained as follows. 
If the exponent (EXP) of the argument is odd: 



Pn = .5 



If the exponent (EXP) of the argument is even; 



/ EXP-1\ / EXP-1 \ 

V 2 ;+ARG\ 2 J 



/ EXP \ / eXP - i\ 

V 2 J+ARG\ 2 ) 



Po = .5 V 2 y+ARG 



Newton's iterative approximation is then applied three times for SQRT or four times for DSQRT. 



{- 



Pi+l = l/2{Pi + ^) 



5.3.2 Sine And Cosine (SIN, COS, DSIN, DCOS) 

The calling sequence for the sine and cosine routines is as follows. 

PC JMS SIN (or COS, DSIN, DCOS) 

PC+ 1 .DSA ARG (+400000 if indirect) 

PC+2 (Error Return) 

PC+3 (Normal Return) 

If the integer portion of the product (ARG*7r/2) is too large (i.e., the exponent of the product is greater than 213), 
return is made to the error return (PC+2) with the AC set equal to 3. Otherwise, return is made to location PC+3 with 
the sine or cosine of the argument in the floating accumulator. 

The argument is converted to quarter circles by multiplying by 2/7r. The low two bits of the integral portion 
determine the quadrant of the argument and produce a modified value of the fractional portion (F) as follows. 
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Low 2 Bits 


Quadrant 


00 


I 


01 


II 


10 


III 


11 


IV 



Modified Value (Z) 

F 

1-F 

-F 

-d-F) 



Z is then applied to the following polynominal expression : 



sin 



x-fe^C2i-HlZ2i+l\ 



where n = 4 for SIN and COS, and n = 6 for DSIN and DCOS. The values of C are as follows. 



SIN, COS 

Ci = .157080 X 10^ 
C3 = -.645964 X 10** 
C5 = 796897 X 10-1 
C7 = -.467377 X 10-2 
C^ - .151484 X 10-3 



DSIN, DCOS 

Ci = .157079633 X 10» 
C3 = -.645964097 X 10« 
C5 = .796926260 X 10-^ 
C7 =-.468175300x10-2 



C9 = .1 60438400 X lO'^ 



Cii =-.359518435 x 10"' 
Ci3 = .544652850 x lO""^ 



The argument for COS and DCOS routines is adjusted by adding 7r/2. The sine function is then used to compute the 
cosine as follows. 



cos X = sin ( — + x) 



5.3.3 ExponentiaKEXP, DEXP) 

The calling sequence for the exponential routines is as follows. 
PC JMS 

PC+1 .DSA 

PC+2 (Error Return) 

PC+3 (Normal Return) 



EXP (or DEXP) 

ARC (+400000 if indirect) 
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If the integer portion of the product ARG*log2e is too large (i.e., the exponent of the product is greater than 213), 
return is made to the error return (PC+2) with the AC set equal to 3. Otherwise, return is made to location PC+3 with 
the exponential of the argument in the floating accumulator. 

The function e^ is calculated as 

2 X log2 e 

which will have an integral portion (I) and a fractional portion (F). Then 



e" = (2') (2F) 



where 



i=0 



and n = 6 for EXP, and n = 8 for DEXP. The values of C are as follows. 



EXP 

Co =. 100000 X 10^ 
Ci =. 346574 X 10« 
C. =. 600566 X 10-» 



C3 -.693801 X 10-2 



C^ = .601 130 X 10-^ 



C5 -.416700V 10-^ 



C^ = . 240977 X 10-^ 



DEXP 

Co =.1 00000000 X 10^ 
Ci =. 346573590 X 10** 



C2 = -600566267 X 10'^ 



C3 =. 693801368 X 10"^ 
C4 = .601 133075 X 10-3 
C5 =.41 6670330 X 10"^ 
Ce =. 240678700 X 10"^ 
C7 =. 1 19610000 X 10-^ 
Cg =.51 8000000 X 10-^ 



5.3.4 Natural And Common Logarithms (ALOG, ALOG10, DLOG, DLOG10) 

The calling sequence for the logarithm routines is as follows. 



PC 



JMS 



ALOG (or ALOG 10, DLOG, DLOGIO) 



5-9(Part II) 



PC+1 
PC+2 
PC+3 



.DSA 

(Error Return) 

(Normal Return) 



ARG (+400000 if indirect) 



If the argument is less than or equal to zero, return is made to the error return (PC+2) with the AC set equal to 2. 
Otherwise, return is made to location PC+3 with the result in the floating accumulator. 

The exponent of the argument is saved as one greater than the integral portion of the result. The fractional portion of 
the argument is considered to be a number between 1 and 2. Z is computed as follows: 

X- n^ 



x+ /T 



then 



log2X=l/2 + (X; C2i+i Z2i+1 
i=0 

where n = 2 for ALOG and ALOGIO, and n = 3 for DLOG and DLOGIO. 
The values of C are as fohows. 



ALOG & ALOGIO 

Cj -. 288539 X 10^ 
C3 = .961471 X 10** 
C5 =. 598979 X 100 

Finally, log^x = (logj x) (logg2) 
and logi X - (logj x) (logi 2) 



DLOG & DLOGIO 

Ci = .288539007 x 10^ 
C3 = . 961800762 X 10« 
C5 =. 576584342 X 10« 
C7 = .434259751 x 10^ 
for ALOG and DLOG 
for ALOG 1 and DLOG 1 0. 



5.3.5 Arc Tangent (ATAN, DAT AN) 

The calling sequence for the arc tangent routines is as follows. 



PC 

PC+1 

PC+2 



JMS 

.DSA 

(Return) 



ATAN (or DAT AN) 
ARG (+400000 if indirect) 
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Return is made to location PC+2 with the arc tangent of the argument in the floating accumulator. There are no error 
conditions. 

For X less than or equal to 1 , Z = x, and 



arc 



tangent x=|X; ^21+ \ Z^i + ^ 
= 



where n = 8 for AT AN, and n = 3 for DAT AN. For x greater than 1 , Z = 1/x, and 



arc tangent 



x = 7r/2-2: 



C2i + 1 2: 



2i+ 1 



where n = 7 for AT AN, and n = 3 for DAT AN. The values of C are as follows. 



ATAN 

Ci = .999999 X 10** 
C3 = -.333299 X 10« 
C5 = .199465 X 10« 
C7 =-.139085x10" 
C9 - .964200 X 10-1 
di = -.559099 X 10-1 
Ci3 = .218612X 10-1 
Cj5 = -.405406 X 10-2 



DATAIM 
Ci = .999215000 X 10" 
C3 =-.321 181900 X 10" 
C5 = .146276600 X 10" 



C7 - -.389929000 X IQ-^ 



To get full 34-bit accuracy in DAT AN, the tangent of the first approximation is taken, and the small angle theory is 
then used to minimize the error angle as follows: 



arctan x = P 



tan (P - x) 
1 + X tan P 



where P is the result of the first approximation. 



5.3.6 Hyperbolic Tangent (TANH) 
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The calling sequence for the hyperbolic tangent routine is as follows. 

PC JMS TANH 

PC+ 1 .DSA ARG (+400000 if indirect) 

PC+2 (Error Return) 

PC+3 (Normal Return) 

If the integer portion of the product x * logsC is too large (i.e., the exponent of the product is greater than 213), 
return is made to the error return (PC+2) with the AC set equal to 3. Otherwise, return is made to location PC+3 with 
the hyperbolic tangent of the argument in the floating accumulator. 

The function 

tanh I X 1= n 



l+e^lx 
e^ is computed as 2^ ^^§2^ which will have an integral portion (I) and a fractional portion (F). Then, 




where 2^ = > QPi and n = 6 



The values of C are as follows. 

Co = . 100000 X 10^ C4 = . 601130 X 10"^ 

Ci -.346574x100 q -.416700x10-^ 

C2 = .600566 x 10-1 ^^ ^ .240977 x 10"^ 



C3 = .693801 X 10 



5.3.7 Polynomial Evaluation {POLY, DPOLY) 

The calling sequence for the polynomial evaluation routine is as follows. 

PC JMS POLY (or DPOLY) 

PC+1 DSA PLIST 

PC+2 (Return) 
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The value of Z must be loaded in the floating accumulator prior to calling POLY or DPOLY. PLIST refers to a list of 
constants stored in contiguous locations within the calling program as follows: 

PLIST -N /2's complement of number or terms 

Cj^ /Last term 

Cn-l 



Co /First term 

Return is made to location PC+2 with the result in the floating accumulator. There are no error conditions. 
The polynomial 

is evaluated as follows. 



X = Z(Co + ZMCi + Z^ (CnZ2+Cj,_i))) 



5.4 FLOATING POINT PACKAGES 

The purpose of the Floating Point Package is to allow PDP- 15/10 users to program for floating-point data using 
simulated floating-point instructions. The Floating Point Package must be assembled and loaded with the user 
program at run time. All simulated floating-point instructions exist as subroutines within this package and must be 
called as such by the user program. 

The reader is referred to Table 5-1 for a tabular summary of all PDP-15/10 mathematical routines. Included in the 
summary for each routine is the name, mnemonic, calUng sequence, function, errors, accuracy, timing, storage 
requirements, and pertinent comments. The following paragraphs provide a brief description of the floating-point 
accumulator, and single-precision, double-precision, and general floating-point operations. 



5.4.1 Floating Point Accumulators 

The floating accumulator is a software accumulator which is included in the Floating Point Package. It is a three-word 
accumulator, %FAC1 being the label of the first word, %FAC2 the second, and %FAC3 the third. Floating-point data 
is stored in the floating accumulator in the following format; negative mantissae are indicated by the setting of bit 
of word %FAC2. 
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% FAC I 



EXPONENT (2'S COMPLEMENT) 



SIGN OF MANTISSA 



17 



% FAC 2 



HIGH -ORDER MANTISSA 



17 



% FAC 3 



LOW-ORDER MANTISSA 



17 



Used by both single- and double-precision routines, this format is also the general format of double-precision 
numbers. Single-precision numbers have a different format and must be converted before and after use in the floating 
accumulator. This conversion is taken care of automatically by the floating arithmetic load and store routines FLAG 
and FDAC (see Table 5-1). The format of single-precision numbers is as follows. 



DATA WORD 1 


LOW ORDER MANTISSA 


EXPONENT {2'S COMPLEMENT) 


C 


) 8 


9 17 




DATA WORD 2 




HIGH ORDER MANTISSA 



17 



5.4.2 Single Precision Operations 

Single-precision routines perform floating-point operations on double-word quantities as described in paragraph 5.4.1. 
The arithmetic operations are performed with one operand in the floating accumulator and the other operand taken 
from storage. The computed result is developed in the floating accumulator, and is accurate to 26 bits. 

All routines in the single-precision floating-point package are summarized in Appendix A. In general, the calling 
sequence for arithmetic routines is as follows; 



JMS 



SUBR 



.DSA 
(Return) 



ARG2 
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where ARG2 is the address of the first location of the argument from storage. The single-precision load and store 
routines (FLAG and FDAC) must be used to load ARGl into the floating accumulator prior to calling an arithmetic 
routine, and to store the result upon return. 



5.4,3 Double Precision Operations 

Double-precision routines perform floating-point operations on triple-word quantities as described in paragraph 5.4.1 . 
The arithmetic operations are performed with one operand in the floating accumulator and the other operand taken 
from storage. The computed result is developed in the floating accumulator, and is accurate to 34 bits. 

All routines in the double precision floating point package are summarized in Appendix A. The calling sequence is the 
same as for single-precision routines except that the double-precision load and store routines (DLAC and DDAC) must 
be used for loading and storing the floating accumulator. 



5.4.4 General Floating Point Operations 

General floating-point routines perform the actual computation for arithmetic operations set up by the individual 
single- and double-precision routines. All arithmetic operations are performed with one operand in the floating 
accumulator and the other in the held accumulator (%HAC1 - %HAC3). All floating-point operations are performed 
on normalized operands. 

All general floating point routines are summarized in Table 5-1 . The calling sequence for these routines is simply 

PC JMS SUBR 

PC+1 (Return) 

except for the unfloat routine %FUNF. This routine is called as follows: 

PC JMS %FUNF. 

PC+1 (Error Return) 

PC+2 (Normal Return) 

where the error return (PC+1) is taken if there is an attempt to unfloat a number that has an integer portion too large 
for an 18-bit word. If the error return is taken, the AC is set equal to 3. Otherwise, return is made to PC+2 with the 
result in the AC. 

5.5 FLOATING POINT I/O 

5.5.1 General Description 

The floating-point input/output (FLIC) program is designed to allow the user to input and output decimal data in 
floating-point format. The program is designed to operate with either the high-speed paper tape reader/punch or the 
ASR33 Teletype. All data transfers are handled through the floating accumulator. FLIC should be assembled and 
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loaded along with the Floating Point Package (FPOINT) and the user program. The user program must initialize 
(select) the device used by FLIO; for example, to select teleprinter output, "TSL+10*' must appear at the beginning 
of his program (See PDP-15 Reference Manual). 



For input, the user program must specify the device as the only argument when calling FLIP (floating-point input). 
The input field is delimited by: 

Tab 211 

Line Feed 2 1 2 

Carriage Return 215 

Slash 257 



The second number of the exponent will also delimit the field. Spaces and illegal characters are ignored until the first 
digit is encountered. If the decimal number is too large, the rightmost extra digits are ignored until the exponent or a 
delimiting character is typed. 

For output, the user program must specify the device and the number of digits to be output when calhng FLOP 
(floating-point output). Output takes place at the current device position; that is, spacing and other formatting 
functions are not automatically performed. 



The following represents device assignments for both input and output. 
ASR33 Teletype 000000 

High-Speed Reader/Punch 400000 



The calling sequence for FLIP is as follows. 

JMS 
xxxxxx 

Next Instr. 



FLIP 



/Subroutine call 
/Device specification 
/Return 



The calling sequence for FLOP is as follows. 

JMS 
xxxxxx+n 

Next Instr. 



FLOP 



/Subroutine call 

/Device specification plus no. 

/of digits to be output (octal) 

/Return 



NOTE 



Again, for both input and output, data transfers are processed through the 
floating accumulator. 
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5.5.2 Input Format And Character Set 

The input format is flexible. The normal form is ± .DDDD... ± EE where the Ds are decimal digits representing the 
mantissa (a maximum of nine digits) and the Es are decimal digits representing the exponent (two digits). Any 
meaningful variation of the normal form is permitted on input. If the decimal point is omitted, the number is assumed 
to be integral. If more than one decimal point is in the input stream, the last one to appear is the one that will be 
used. A plus or minus sign after at least one number of the mantissa field will signal the program that the next two 
digits are exponent digits. 

The input character set is as follows. 



Space Tab 

0, 1. . , .9 Carriage Return 

Line Feed 
Examples 

123.123E4 = 1231230. 

.123123-4 = .0000123123 

-1.23.123 = -123.123 

+123123 = 123123. 

5.5.3 Output Format And Character Set 

The output format is rigid. The user can specify as many digits to be output as he wishes between one and nine 
(inclusive).* After the last mantissa is typed/punched, a plus is output if the exponent is positive and a minus sign is 
output if the exponent is negative. The output character set includes the following. 



0, 1.. .9 
Space 



*If the argument to FLOP is 0, an "x" is printed, if the argument specifies more than nine decimal digits, an "x" is printed along with the 
first nine digits. 
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Examples 

.12312300+04 

.123-4 

.1+10 
All output is rounded. For example, 

JMS FLOP 

6 

indicates that the user wishes to output six decimal digits. If his internal number is .123456789E12, his output would 
be rounded as follows. 

.I23457+E12 
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assembled, the General Float- 
ing Point tape must also be as- 
sembled. See Chapter 1. 




Product in Floating Accumula- 
tor 

Sum in Floating Accumulator 

Quotient in Floating Accumu- 
lator 


Either FLIP or FLOP can be 
deleted by conditional assem- 
bly, see Chapter I. 
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Device is specified as: 
000000 for TTY 
400000 for high-speed paper- 
tape reader punch 
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APPENDIX A 
CHARACTER SET 







6-bit 






6-bit 


Printing 


7-bit 


Trimmed 


Printing 


7-bit 


Trimmed 


Character 


ASCII 


ASCII** 


Character 


ASCII 


ASCII** 


m 


100 


oott 


(Space) 


040 


40 


A 


101 


01 


! 


041 


41 


B 


102 


02 


''t 


042 


42 


C 


103 


03 


#t 


043 


43 


D 


104 


04 


$t 


044 


44 


E 


105 


05 


% 


045 


45 


F 


106 


06 


& 


046 


46 


G 


107 


07 


,t 


047 


47 


H 


110 


10 


( 


050 


50 


I 


111 


11 


) 


051 


51 


J 


112 


12 


* 


052 


52 


K 


113 


13 


+ 


053 


53 


L 


114 


14 


' 


054 


54 


M 


115 


15 


- 


055 


55 


N 


116 


16 


. 


056 


56 


O 


117 


17 


/ 


057 


57 


P 


120 


20 





060 


60 


Q 


121 


21 


1 


061 


61 


R 


122 


22 


2 


062 


62 


s 


123 


23 


3 


063 


63 


T 


124 


24 


4 


064 


64 


U 


125 


25 


5 


065 


65 


V 


126 


26 


6 


066 


66 


w 


127 


27 


7 


067 


67 


X 


130 


30 


8 


070 


70 


Y 


131 


31 


9 


071 


71 


z 


132 


32 


:t 


072 


72 


[t 


133 


33 


> 


073 


73 


\ 


134 


34 


<t 


074 


74 


]t 


135 


35 


= 


075 


75 


tt 


136 


36 


>t 


076 


76 


^t 


137 


37 


?t 


077 


77 


Null (Blank) 


000 










Horizontal Tab 


Oil 










Line Feed 


012 










Vertical Tab 


013 










Form Feed 


014 










Carriage Return 


015 










Rubout 


177 











Notes: 



All other characters are illegal and are flagged and ignored 
t = Illegal as source except in a comment or text; Ignored by %TOC and %T0C1. 
tt = Ignored by %TOC and %T0C1. 
** = .SIXBT pseudo-op text value. 
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APPENDIX B 
PERMANENT SYMBOL TABLE 



Memory Reference 



CAL 


000000 


DAC 


040000 


JMS 


100000 


DZM 


140000 


LAC 


200000 


XOR 


240000 


ADD 


300000 


TAD 


340000 


XCT 


400000 


ISZ 


440000 


AND 


500000 


SAD 


540000 


JMP 


600000 


Operate 


OPR 


740000 


NOP 


740000 


CMA 


740001 


CML 


740002 


OAS 


740004 


RAL 


740010 


RAR 


740020 


lAC 


740030 


HLT 


740040 


XX 


740040 


SMA 


740100 


SZA 


740200 


SNL 


740400 


SML 


740400 


SKP 


741000 


SPA 


741100 


SNA 


741200 


SZL 


741400 


SPL 


741400 


RTL 


742010 


RTR 


742020 


SWHA 


742030 


CLL 


744000 


STL 


744002 


CCL 


744002 


RCL 


744010 


RCR 


744020 


CLA 


750000 



Operate (Cont) 


CLC 


750001 


LAS 


750004 


LAT 


750004 


GLK 


750010 


LAW 


760000 



I/O States 

lOT 700000 

lORS 700314 
CAF 703302 



Interrupt 



lOF 
ION 



700002 
700042 



Teletype Keyboard 

KSF 700301 

KRB 700312 

KRS 700322 

Teletype Teleprinter 

TSF 700401 

TCF 700402 

TLS 700406 

Paper Tape Reader 



RSF 


700101 


RCF 


700102 


RSA 


700104 


RRB 


700112 


RSB 


700144 



Paper Tape Punch 



PSF 


700201 


PCF 


700202 


PSA 


700204 


PSB 


700244 
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Index and Limit Register Instructions 



Index and Limit Register Instructions (cont) 



AAS 


720000 


AAC 


723000 


AXS 


725000 


CLLR 


736000 


AXR 


737000 


CLX 


735000 


PAL 


722000 


PAX 


721000 


PLA 


730000 


PLX 


731000 



PXA 724000 

PXL 726000 

Mode Switching and Listing Instructions 

EBA 707724 

DBA ^07722 

SBA 707721 

Index Register 

X 10000 
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APPENDIX C 
SUMMARY OF PSEUDO-OPS 



.BLOCK 

.DEC 
.DSA 

.END 

.ENDC 
.EOT 

.FULL 

.IFDEF 

.IFUND 

.LIST 
.LOC 

.OCT 

.SIXBT 

.SIZE 

.XLIST 



Paragraph 

1.4.3.1 

1.4.4 
1.4.6 

1.4.1 

1.4.7 
1.4.2 

1.4.10 
1.4.7 

1.4.9 
1.4.8 

1.4.4 

1A5 

1.4.11 

1.4.9 



Format 
label H .BLOCK H expV 

-^ .DEC^ 
label -^ .DSA i^ expj 

^.END 1-1 START J 

-*).ENDCj 
-*\ .EOT J 

-^.FULL^ 
-J.IFxxx i_i exp^ 

H .LIST J 

H .LOC i_i expJ 

^ .OCT J 

label -^ .SIXBT i_i /text/ J 

label -^ .SIZE^ 



H XLISTJ 



Function 

Reserves a block of storage words equal 
to the expression. If a label is used, it 
references the first word in the block. 

Sets prevailing radix to decimal. 

Defines a user symbol which is to be 
used only in the address field. 

Must terminate every source program. 
START is the address of the first 
instruction to be executed. 

Terminates conditional coding in JF 
statements. 

Must terminate physical program 
segments, except the last, which is 
terminated by .END. 

Produces hardware readin binary tapes. 

If a condition is satisfied, the source 
coding following the .IF statement, and 
terminating with an .ENDC statement, is 
assembled. 

Resume printing of assembly listing. 

Sets the Location Counter to the value 
of the expression. 

Sets the prevailing radix to octal. 
Assumed at start of every program. 

Input text strings in 6-bit trimmed 
ASCII, with first character as delimiter. 

The Assembler outputs the address of 
last location plus one occupied by the 
object program. 

Suppress printing of assembly listing. 
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APPENDIX D 
PDP-15/10 HARDWARE READIN BINARY LOADERS 



/PDP-15/10 HARDWARE REAOIN LOADERS 

/DEFINING %LOW PRODUCES THE LOW SPEED VERSION 
/OTHERWISE, THE HIGH SPeEO VeRSION IS PROqUcED. 

/ 

/LOW SPEED READER VERSION: 

/HARDWARE REAOIN TO 7700 (I770PS IF 8K). WHEN IT HALTS, 

/PLACE BINARY PROgRaM ^aPE IN LOW SPEED READER 

/AND PRESS START, WITH BANK/PaGE MODE SWITCH IN PAGE POSITION. 

/ 

/IIGH SPEED READER VERSION: 

/HARDWARE READIN TO 7720 (17720 IF 8K). WHEN IT HALTS, 

/PLACE BINARY PROGRAM TAPE IN HIGH SPEED READER 

/AND PRESS START, WITH BANK/PAGE MODE SWITCH IN PAGE POSITION. 

/ 

/LOADER halts: 

/ 

/AC=777777 - PROGRAM LOADED. 

/AC-N0N2ER0 - CHECKSUM ERROR ON LaST bLOcK LOaDED. 

/ Reposition TaPe aT blank frame prior to 

/ BEGINNING OF LAST BLOCK AND PRESS START 

/ TO REREAD. 

/ TO IGNORE ERROR, PRESS CONTINUE. 

/ 

CAF=703302 

RSF=700101 

RSP=700144 

RRB=700112 

KSF=700301 

KRB=700312 

KRS=700322 

.FULL 
SKPFLG=RSF 
RDSLCTzRSB 
RDBFR=RRB 

.LqC 17720 

. IFOEF %L0W 
SKPFLG=KSF 
RDSLCT=KRS 
RORFR=KRB 

.LOG 17700 

.ENDC 

CAF /CLEAR FLAGS 

LONXbK d2M LDCKSM /CHECKSUMMING LOCATION 

^HS LDREAD /GET A WORD 

SPa ^° ^° /BLOCK HEADING-LOADING ADDRESS 

JMP LDXFR /START BLOCK 

JMS LDREAD 

DAC LOWOCT /WORD COUNT (2'S COMPLEMENT) 

JMS LOREAO 
LDNxWD JMs LDrEAD 



DAC* LDSTaD /LOAD DATa INTO 
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ISZ LOSTaO 
rS2 LD^^DCT 



/MEMORY 
/FINISHED LOADING 



LDXFR 



LDREAO 



LDRDA 



LDCTR 
LDTMP 
LDMSK 

LDCKSM 
LDSTAD 
LDWDCT 



JMP LONXWD 

TAD LDCKSM 

SZA 

HLT 

JMP LDNXBK 

DAC LDWDCT 

ISZ LDWDCT 

JMP* LdSTaD 

CLClHLT 



. IFDEF %LOW 

LAW -3 

DAC LDCTR 

DZM LDTMP 

.ENOC 

Tad LDCKSM 

DAC LDCKSM 

RDSLCT 

SKPFLG 

JMP .-1 

RDBFR 

, IFDEF %LOW 

Tad lomsk 

SPAICLL 
JMP LDRDA 
Tad LDTMP 
IS2 LDCTR 
SKPIRTL 
.ENOC 

JMP» LDREaD 
. IFDEF %L0W 

rtl 

RTL 

DAC LDTMP 

JMP LDRDA 





777600 
.ENOC 




.END 



/NO 

/ADD INTO CHECKSUM 

/CHECKSUM ERROR 



/EXECUTE START ADDRESS 
/MANUALLY STaRT USER PROGRAM 



/Wait for reader 

/READ buffer 

/binary frame 

/YES 

/no 



/ACCUMULATE 3 FrAmFS 
/into 1 BINARY WOrD 



/PACK COUNTER 
/BINARY WORD 
/binary frame MASK 

/CHECKSUM 

/LOADING/STARTING ADDRESS 
/WORD COUNT 
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Transfer from Edit Level to Input Level 

X)(,_,>) 

Transfer from Input Level to Edit Level 

J 

CTRLP 

Text Input/Output 

S( U-. n)J 
READ^ 

G( L_. n)^ 



RENEW J 
WRITE J 

CLOSER 

Pointer Manipulation 
TJ 

N( t_j n)J 
F t-j string J 

L I I string J 

*n lines are deleted from the buffer before the control level is changed. 



APPENDIX E 
SUMMARY OF EDITOR COMMANDS 

Carriage return as first character. 
INSERT command with no arguments. 
OVERLAY command.* 

Carriage return as first character, 
(echoes tP) 

(SIZE) Sets number of lines to occupy buffer. 

Reads sequential lines from input device; number 
of lines specified by SIZE command. 

(GET) Adds next n lines from subsidiary device to 
the buffer. 

Writes contents of buffer and reads new block. 

Punches contents of buffer on output device and 
clears buffer. 

Writes remainder of input file on output device; 
must be preceded by a WRITE command. 

(TOP) Moves pointer to top of buffer. 

(NEXT) Moves pointer past next n lines. 

(FIND) Searches buffer to find next line that 
begins with string. 

(LOCATE) Searches buffer to find next line that 
contains string. 

(BOTTOM) Moves pointer to final line in buffer. 
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SEARCH uj string^ 

Editing Requests 

R I I line^ 

A I I string^ 

C L_i qstringlqstring2q^ 

I I I line^ 

G( ,_i n)^ 
D( ._. n)^ 
0( U-. n)J 

Examination Requests 
P( ^^ n)J 

V 



B 



/ON\ 

t_il offJ 
/on\ 

i_j^OFF/ 



Searches input file for next line that begins with 
string. 



(RETYPE) Replaces the current line with ''line." 
(APPEND) Adds "string" to current line. 
(CHANGE) Replaces string 1 with string2. 

(INSERT) Inserts 'line" after current line. 

(GET) Adds n lines from subsidiary input device 
after current line. 

(DELETE) Deletes next n lines from buffer. 

(OVERLAY) Deletes next n lines from buffer and 
transfers control to input level. 



(PRINT) Prints next n lines on Teletype. 

(VERIFY) Causes text lines to be printed in 
response to certain commands. 

(BRIEF) Causes abbreviated printing of VERIFY 
lines. 
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APPENDIX F 

CREATING ASCII TEXT WITH THE EDITOR 
(Using ASR33 Reader/Punch) 

This appendix contains procedures intended for the user who is not familiar with the Editor, but wishes to create 
ASCII text on paper tape immediately. The basic procedure includes loading the paper tape containing the Editor mto 
core memory completing an initialization sequence, typing the desired text on the Teletype, and punching out the 
text (which has been held in the Editors buffer). It is assumed that the low-speed (ASR33) paper tape reader and 
punch are to be used. Appendix D contains detailed examples of basic Editor operation, and Appendix E contams a 
comprehensive Editor demonstration. 

To punch leader: 

1. Turn Teletype switch to OFF LINE. 

2. Press Teletype punch switch ON. 

3. Press HERE IS key several times to generate leader. 

4. Press Teletype punch switch OFF. 

5. Turn Teletype switch ON LINE. 
To load the Editor: 

6. Place the tape containing the low-speed, hardware readin binary loader in the Teletype reader. 

7. Press Teletype reader switch ON. 

8. Set ADDRESS switches to 7720 (17720 for 8K systems). 

9. Press I/O RESET and READIN. The computer will halt (AC = 777777). 

10. Press reader switch OFF and place binary tape of Editor in Teletype reader. 

11. Press reader switch ON and press START. The Editor will be loaded into memory (this takes about 3-1/2 
minutes using the ASR33 reader). 

To initialize the Editor: 

When loading is complete, the Editor types 

EDIT- 15 
INTXT* 

12. You type: ^) 

The Editor types: GETXT* 



F-l(Partll) 



13. You type: LJ 

The Editor types: OUTXT* 

14. You type: Lj 
The Editor types: EDIT 

followed by: > 

15. You type a carriage return following the right angle bracket, and the Editor responds 

INPUT 

To create your ASCII text: 

16. Just type it in. Each line should consist of less than 72 characters followed by a carriage return. If you make a 
mistake, don't worry about it now. Make a note of it and, when you have finished creating your text, you can edit it 
using basic Editor commands illustrated in Appendix D. The Editor will store your ASCII text in a 20-Iine buffer 
(55-Iine buffer for 8K systems). When you have typed enough lines to fill the buffer or when you have finished 
creating your text (whichever occurs first), proceed with the following steps. 

To punch out the contents of the buffer: 

17. Type a carriage return as the first character on a line. The Editor will respond 

EDIT 

> 

18. You type WRITEJ following the right angle bracket. 

1 9. Press Teletype punch switch ON. 

20. Press CONTINUE. The Editor will punch out the buffer. When punching stops 

21 . Press the Teletype punch switch OFF. 

22. Press CONTINUE. The Editor will respond with 

> 

23. If you wish to continue creating text, return to step 15. If you are finished creating text, return to steps 1 
through 5 to generate trailer in the same manner that you generated leader. 
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APPENDIX G 
EXAMPLES OF EDITOR OPERATION 

This appendix is intended for the user who is not acquainted with the Editor, but has an ASCII tape that he wishes to 
modify. Basic editing can be accomplished using only two I/O commands (READ and WRITE) and six editing 
commands (INSERT, RETYPE, DELETE, PRINT, NEXT, and TOP). Most editing jobs can be accomphshed using 
these simple commands; the following editing session illustrates their use. 

(1) To get things started, load the Editor into memory and initialize it by following the procedure in paragraph 
2.3. 

(2) Make sure the Teletype reader switch is OFF. 

(3) Place the tape containing the ASCII text to be edited in the Teletype reader. 

(4) Type READ^ 

(5) The Editor will halt. Turn the Teletype reader switch ON. 

The Editor will read 20, o lines (55 j o for 8K systems) into a block buffer &nd halt. Turn the Teletype reader switch 
OFF and press CONTINUE. The Editor will type a right angle bracket (>) in the left margin. This is the signal that 
the Editor has finished processing your last command (READ) and is ready to accept your next command. You can 
now perform the following editing operations. 

To obtain a listing of the text in the Editor's buffer: 

a. Type TO? J 

This moves the current-line pointer to the beginning of the buffer. 
The Editor types > 

b. Type PRINT i_i 22^ 

This commands the Editor to print 22 lines, starting with the current hne. The number 22 includes the 20 hnes 

in the buffer, one pseudo hne at the beginning of the buffer, and one extra line to make sure you get 

everything. 

The Editor types: 

(Line 1 of original text) 



(Line 20 of original text) 

END OF BUFFER REACHED BY 

PRINT 22 

> 



To insert a line at the top of the buffer (before line 1 or original text): 

a. TypeTOPJ 

The Editor types > 



*If an out-of-tape condition occurs during the READ (e.g., the ASCII text is less than 20,0 lines), you can continue by typing CTRL R. 
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b. Type INSERT i-j (Line to be added before line 1) 
To verify this change : 

a. TypeTOP^ 

The Editor types > 

b. Type PRINT i-i 3^ 

The Editor types: 



(Line 1 to be added) 
(Line 1 of original text) 
> 



To change line 5 instead of verifying as above : 



a. Type NEXT i-J 4^ 

This moves the current-line pointer from Une 1 of the original text to line 5 of the original text. 
The Editor types > 

b. Type PRINT J 

This will allow you to verify that the current-line pointer is in fact pointing at the line you wish to modify. 
The Editor types: 



(Line 5 of original text) 
> 



c. Type RETYPE i_i (New version of line 5)^ 
The Editor types > 

To add four lines after line 7 : 

a. Type NEXT i-i 2 

This moves the current-Hne pointer to line 7. 
The Editor types > 

b. Type INSERT^ 

The Editor types INPUT 
You type; 



The Editor types: 



(Line 1 to be inserted)^ 
(Line 2 to be inserted)^ 
(Line 3 to be inserted)^ 
(Line 4 to be inserted)^ 

EDIT^ 

> 



To verify your insertion: 
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a. Type TOP >•? 

The Editor types > 

b. Type NEXT i_i 8^ 

(You typed 8 as the parameter for NEXT since you wish to move the pointer down through seven lines of 
original text plus the hne you added at the top.) 
The Editor types > 

c. Type PRINT i-J 6^ 
The Editor types: 

(Line 7 of original text) 
(Line 1 to be inserted) 



(Line 4 to be inserted) 
(Line 8 of original text) 
> 

To delete lines 11, 13, and 1 4 : 

a. Type NEXT t-j 3^ 
The Editor types > 

b. TypePRINT^i) 

(To verify the position of the current-line pointer.) 
The Editor types: 

(Line 11 of original text) 
> 

c. Type DELETE^ 
The Editor types > 

(The current-line pointer is now positioned at line 12, the line after the line deleted.) 

d. TypeNEXT^ 
The Editor types > 

e. Type DELETE i_j 2^ 
The Editor types > 

Now you have added 5 lines to the original 20 lines read, deleted 3 lines, and modified 1 line. You now have 22 hues 
in your buffer. To verify that this block is as you want it, issue a TOP command followed by a PRINT i— j 24 
command. 

To punch out the edited block: 

a. Type WRITER 

The Editor halts. Turn on the Teletype punch and press CONTINUE. 

The Editor punches out the block buffer (tabs will not appear in the listing) and halts. 
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Turn off the Teletype punch and press CONTINUE. 
The Editor types > 

You now have the option of returning to step 4 to fill the buffer and edit more previously prepared text, or using the 
INSERT command to fill the buffer. In either case, if the buffer is filled again, a WRITE must precede further 
READs. If starting a new editing job, type CTRL P to clear all buffers before beginning. 
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APPENDIX H 
EDITOR DEMONSTRATION 

This appendix provides a comprehensive example of an actual editing session. Before attempting to follow the 
example in this appendix, the user should perform the operations outlined in Appendices F and G, and read sections 
2.3 and 2.4 to familiarize himself with the Editor. The first page shows the editorial changes that are to be made to an 
ASCII tape. The next several pages show hardcopy output of the editing session, and the last page shows an assembly 
listing of the newly edited file. The following comments are keyed to the two pages containing the hard-copy output 
of the editing session. 

1) After initializing the Editor to READ text from the high-speed paper tape reader, to GET subsidiary input 
from the Teletype reader, and to WRITE edited text on the high-speed punch, the user must READ a block of text 
before editing can begin. 

2) User types a carriage return to ignore CAPACITY WARNING. 

3) The user has misspelled a command. It must be retyped in order to be executed. After the command has been 
executed, PRINT is used to verify the results. 

4) The use of command abbreviations saves time. 

5) The user should have simply typed - 

I i_-i ISZ PACK /BUMP TO "TO" ADDRESS 

instead of changing from edit level to input level, typing the line, followed by another carriage return to get back to 
edit level. 

6) Verification is truncated with BRIEF ON, and prints out only up to the character changed. This saves time on 
long editing jobs. 

7) Verification can be ehminated by the confident user. 

8) The end of the buffer has been reached. The user must now issue a WRITE followed by a READ to continue. 

9) The editing task is now complete. The user issues a WRITE to finish punching out his edited tape. 
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Input File Marked For Editing 



oS^^ 



/SUBHOUTINE PACK 
/CALL: JMS 
/ FROfO 
/ TO 
PACK ^ it 
LACt' 

DAC 

PLOOPl LAW 
DAC 
PLOOPii LAC* 

Ji^P 
ISZ 

•we 



, 7-3IT^CHARS TO'loPS ASCII. 
PACK 



i.05 



72?rA^ 



oVA^^^^^^^'Ji^^C? 



^^^^ sy 



PK^^ 



rt 



^ ?Krr5 rJ'.%>A'«v*>'-' 






5^Ct 



PACK 

PFHO.n 

PACK 

PTO 

PL&H 

PACK 

17773 

PK5CHH 

PFR0;1 

PCLOS 
PFhOi'i 



PL00P7 



DAC 
JfiS 
ISZ 

Jilp 

LAC 



PWHD3 
PRAL7 ^ 

/2S>C0P2 
PWRD2 



DAC* 
ISZ 
Ji*lP 
LAW 
jfSfSAD 
.Ji'^P 



PCLOS 
02M 



RAL/6*iL 

DAC* PWRD2 

LAC PWRDl 

RAL'I GLL ^ 

PTO 

PTQ.^^ 

PLfiaFl 

17773 

PK5CHR 

PL00P7 



oo 




PkBM^ 



fro ^ 




CilA 

AD 
Iji^P* 
^END 



PTO 
PACK 



/GET FROl^I A IIRESS, ^D 
/GIVE TO FROiT POlNTErtV 
/uET ADDRESS OF TO ARRAY. 
/GIVE TO OUTPUT POINTER. 
/SAVE AS START ADDRESS. 
/bUi^iP TO RETURN. 
/SET UP - ^^ 

/GET NEXT WORD IN INPUT ARRAY. 
/TERilINATOR? 

/YES, GO CLOSE OUTPUT ARRAY. 
/POINT TO NEXT WORD. 
M^O t h-J TO MEKT wonii ), r 
/SET UP TO ROTATE. 

/5 CHARS IN ^r* • 
/NO, GET ANOTHER. 
/WORD PAIR COi^PLETE. 
/CLEAR PAIR BIT 35. 

/GET FIRST WD OF PaS^. 

/BIT OF WD 2. ^^ 

/INSERT FIRST WD IN OUT ARRAY. 

/BUilP OUT ADDRESS. 

/GO SET UP NEXT PAIR. 

/ilAKE SURE PAIR IS COMPLETE. 

/INCOilPLETE PAIR. 

/FORi^ WORD PAIR COUNT/O 

/START ADDRESS. V-X 

/LESS END ADDRESS. 
/RETURN TO CALLER. 
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Hard-Copy Output of Editing Session 
tDlT-13/10 

INTXT* 

H 

GETXT* 

L 

OUTXT^ 

H 

LJIT 

>rt£AD 

>FIND /SUBHOUI 

/SUBHOUTINE PACK, 7-dlT CHARS TO lOPS ASCII. 

>OVERLAY 1 

INPUT 

/SUBROUTINE PACK, 7-bIT LEFT-AUJUSTED CHARS TO NON-HEADu-RED lOPS 

/hSCII. on rtETURt^, AC HOLJS TOTAL WORDS OCCUPIED BY PACKED AHRiK 

CAPACITY WARNING 

/A WORD OF ALL I'S i^UST TERiilNATE THE INPUT (UNPACKED) ARRAY. 

CAPACITY WARNING 



PACK 



EDIT 
>LOCATE FROil 

/ FR Oil 
>APPEND 
>NEXT 
>AP£ND 
NOT A REQUEST: 

APEND 
>APP£Nu 
>PRINT 1 

/ TO 
>L LAC 

LAC 
>CHANGE LAC/LAC*/ 

LAC PACK 

>CHANGE /LAC/LAC*/ 

LAC* PACK 

>C /hDR/mDDR/ 

LAC* PACK 

>NEXT 1 
>INSERT 

Capacity warning 

INPUT 

ISZ PACK 

CmPmCITY WARNING 



/START OF INPUT ARRAY. 

/START OF OUTPUT ARRAY. 

/START OF OUTPUT ARRAY. 

/START OF OUTPUT ARRAY. 



/START OF OUTPUT ARRAY. 

/GET FROi^i ADRESS. 
/GET FRO^'l ADRESS. 
/GET FROL^i ADRESS. 
/GET FROM ADDRESS. 



/oU/iP TO "TO" AUJRESS. 
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Hard-Copy Output of Editing Session (cont) 



EDIT 
>PrtINT 

ISZ PACK 
>BHIEF ON 
>C ./ •/. 

ISZ PACK 
>PrtlNT 

ISZ PACK 
>L PLBH 

DAC PLBH 
>&HI£F OFF 
>PKINT 

DAC PLBH 
>DtL£TE 2 
>PHINT 

PLOOPi LAW 17773 
>N i 

>A /5-CHARACTER COUNTER 
>L ( 

SAC (-1 
>V£RIFY OFF 
>C /SAC/SAD/ 
>C /g\(-l/tNDCHR/ 
>V ON 
>PRINT 



/BUi^iP TO "TO" ADDRESS. 



/BUi^P TO "TO" ADDRESS. 



/SAVE AS START ADDRESS 
/SET UP 

/TERiilNATOR? 



>N 
>D 
>M 
>P 

>D 
>P 



SAD 



ISZ 



ENDCHR 



PFROil 



/TERi^ilNATQR? 

/POINT TO NEXT WORD. 
/POINT TO NEXT WORD. 



ISZ PFROtI 
>F PL 

END OF BUFFER REACHED BY: 
F PL 
>W^ 
>RlAD 
>F PL 

PL00P7 JilS PRAL7 
>N 

>RETYP£ ISZ PK5CHR 5\/5 CHARS IN? 
>N 
>C ,LP,PL, 

JMP PL00P2 /NO, GET ANOTHER. 

>N 2 
>CHANGE /L/LICLL 

RALICLL /CLEAR PAIR BIT 35. 
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Hard-Copy Output of Editing Session (cont) 



>N Z 






>P 








LAC 


PWHDl 


>C /H./IH/ 






LAC 


PWriDl 


>L HAL 


HALICLL 




>C /ICLL// 






RmL 




>L JilP 








Ji^P 


PLW0P1 


>CHANG£ 


/00/OO/ 






Ji^P 


PLOOPi 


>i^i 






> 






INPUT 








DZi^ PWRD3 


EDIT 






>L \ 







/GET FIRST WD OF PAR.. 

/u£T FIRST WD OF PAIR. 
/dIT OF WD 2. 
/dIT OF WD 2. 

/GO SET UP NEXT PAIR. 

/GO SET UP NEXT PAIR. 

/FILL PAIR WITH ZEROES 



CLAICLL /F0R;1 WORD PAIR COUNT 
>R ENDCHH LAW -1 /F0R»1 WORD PAIR COUNT. 
>N 

>R TAD=*= PACK /START ADDRESS. 
>L PTO 

TAD PTO /LESS END ADDRESS. 

>INS£RT ISZ PACL\K 
CAPACITY WARNING 

>BOTTOi^l 

.ENu 
>Ov/ERLAY 
INPUT 
PFHOi^i k3 

CAPACITY WARNING 
PTO 

Capacity warning 

PK5CHR 

capacity warning 

.END 
CAPACITY WARNING 

EDIT 

>WRIT£ 
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Edited Output File 



PLEASE READY THE INPUT DEVICE AND SET THE AC SWITCH 



/SUBKOUTINE 


PACK, 7-BI 


/ASCII. 


ON 


RETURN, AC 


/A WOHD 


OF ALL i'SiiUS 


/CALL: 


Jt^S 


PACK 


/ 


FHOiv] 




/ 


TO 




PACK 


16 






LAC* 


PACK 




DAC 


PFHQ^ 




isz 


Pack 




LAC^^ 


PACK 




DAC 


PTO 


PLOOPi 


LAW 


i7773 




DAC 


PK3CHR 


PL00P2 


LAC* 


PFROfI 




SAD 


ENDCHR 




JrtP 


PCLOS 




ISZ 


PFROIi 




DAC 


PWRD3 


PL00P7 


J AS 


PRAL7 




ISZ 


PK5CHR 




Ji'OP 


PL00P2 




LAC 


PWRD2 




RAL! 


CLL 




DAC 


PWRD2 




LAC 


PWRDl 




HAL 






DAC* 


PTO 




ISZ 


PTO 




Jt^P 


PLOOPI 


PCLOS 


LAW 


17773 




DZi^ 


PWRD3 




SAD 


PK5CHR 




j:^p 


PL00P7 


ENDCHR 


LAW 


-1 




TAD* 


PACK 




TAD 


PLBH 




Ci^A 






TAD 


PTO 




ISZ 


PACK 




J. IP* 


PACK 


PFHOil 


Id 




PTO 






pk;?chk 




.END 





LEFT-ADJUSTED CHARS TO NON-HEADERED lOPS 
HOLDS TOTAL WORDS OCCUPIED BY PACKED ARRAY. 
TERi^JlNATE THE INPUT (UNPACKED) ARRAY. 

/START OF INPUT ARRAY. 
/START OF OUTPUT ARRAY. 

/GET FROi^l ADDRESS. 

/GIVE TO FHOrt POINTER, 
/BUhP TO "TO" ADDRESS. 

/GET ADDRESS OF TO ARRAY. 

/GIVE TO OUTPUT POINTER. 

/SET UP 
/5-CHARACTER COUNTER. 

/GET NEXT WORD IN INPUT ARRAY. 

/TERi^INATOR? 

/YES, GO CLOSE OUTPUT ARRAY. 

/POINT TO NEXT WORD. 

/SET UP TO ROTATE. 

/5 CHARS IN? 

/NO, GET ANOTHER. 
/WORD PAIR COi*lPLET£. 
/CLEAR PAIR BIT 35. 

/GET FIRST WD OF PAIR. 

/BIT OF WD 2. 

/INSERT FIRST WD IN OUT ARRAY. 

/BUi^P OUT ADDRESS. 

/GO SET UP NEXT PAIR. 

/ilAKE SURE PAIR IS COilPLETE. 

/FILL PAIR WITH ZEROES. 

/INCOi^PLETE PAIR. 
/FORt^ WORD PAIR COUNT. 
/START ADDRESS. 

/START ADDRESS. 

/LESS END ADDRESS. 
/RETURN TO CALLER. 
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APPENDIX I 
ASCII CHARACTER SET 



MODEL 33ASR TELETYPE CODE (ASCII) IN OCTAL FORM 



Character 


8-Bit Code 
(in Octal) 


Character 


8-Bit Code 
(in Octal) 


A 


301 


1 


241* 


B 


302 


5* 


242* 


C 


303 


# 


243* 


D 


304 


$ 


244 


E 


305 


% 


245* 


F 


306 


& 


246* 


G 


307 


' 


247* 


H 


310 


( 


250* 


I 


311 


) 


251* 


J 


312 


* 


252* 


K 


313 


+ 


253* 


L 


314 


' 


254* 


M 


315 


— 


255* 


N 


316 


. 


256* 


O 


317 


/ 


257 


P 


320 


: 


272* 


Q 


321 


It 


273 


R 


322 


< 


274* 


S 


323 


= 


275* 


T 


324 


> 


276* 


U 


325 


7 


277 


V 


326 


@ 


300*t 


w 


327 


[ 


333* 


X 


330 


\ 


334* 


Y 


331 


1 


335* 


Z 


332 


t 


336 





260 


-f- 


337 


1 


261 


Leader/Trailer 


200** 


2 


262 


Line-Feed (I ) 


212t 


3 
4 


263 
264 


Carriage-Returnf^ 
Space (A) 


215t 
240 


5 


265 


Rub-out 


377** 


6 


266 


Blank (Null) 


000** 


7 


267 


ALT MODE ($) 


373 


8 


270* 


Tab 


211t 


9 


271* 







*Not recognized by ODT. 

**Ignored by ODT. 

fHave special meaning to TIC & TOC. 
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APPENDIX I 
ODT COMMAND SUMMARY 



Register Examination and Modification 

k/ 

/ 

) 

\ 

t 

SA 
$J 

Execute Instruction 

k$X 

Setting User Start Address 

$Z 

$G 
k$G 



Open register k. 

Open last referenced register. 

Close register. 

Store k and close register. 

Close register and open next register. 

Close register and open previous register. 

Close register and interpret contents as address. 

Open AC and Link registers. 

Display PI and API status. 



Execute instruction k. 



Open user start address. 

Start program at address specified in $Z register. 

Start program at location k. 



Breakpoint Commands 

k$B 

k$nB 
$B 

$nB 

$C 

k$C 



$K 
$U 
$V 
$Y 



Set breakpoint 1 at location k. 

Set breakpoint n at location k. 

Remove all breakpoints. 

Remove breakpoint n. 

Execute instruction at breakpoint and continue 

with user program. 

Execute instruction at breakpoint and continue 

with user program when the breakpoint has been 

encountered for the kth time. 

Disable PI and API during all breakpoints. 

Enable PI and API during all breakpoints. 

Vary autoindex (must be between 10 and 17). 

Open re-entrant PC Ust (after re-entrancy error). 



Searching Operations 

$M 

k$W 



Open mask register for modification. 
Search for bit configuration k. 
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Initialize Buffers 



^^ Initialize (set) block of memory locations to zero. 

^^^ Initialize (set) block of memory location to k.* 



Paper Tape Output 



^H Select high-speed punch. 

$L Select low-speed punch. 

^I'^^s $D Dump (punch) all locations between k, and kj , 

inclusive. 
^T Punch terminal block; loader will halt when 

loading complete. 
^^"^ Punch terminal block; loader will transfer to 

location k when loading complete. 



*User must first specify high and low limits of block by means of $M command, 
*If low-speed punch ($L), ODT halts to allow user to turn-on punch. 
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PARTm 

Basic I/O MONITOR 








-mt^ 



PART III 
BASIC I/O MONITOR 




CHAPTER I 
THE PDP-15 MONITOR ENVIRONMENT 



Ll MONITOR FUNCTIONS 

The Basic I/O Monitor greatly simplifies the task of programming I/O functions by providing an interface between 
system or user programs and the external world of I/O devices. Upward compatibihty exists between the Basic I/O 
Monitor and the other monitors of the PDP-15 Software System; programs written to operate under control of the 
Basic I/O Monitor will also operate, without modification, under control of the Advanced and 
Background/Foreground Monitors. The Monitors, by means of the Input/Output Programming System (lOPS) and 
Program Interrupt (PI) or Automatic Priority Interrupt (API), allow simultaneous operation of multiple I/O devices 
along with overlapping computations. 

Certain features such as the general Monitor environment, data handling, and logical/physical I/O device associations, 
are common to all three Monitors. Detailed information on the Advanced and Background/Foreground Monitors will 
be found in manuals DEC-15-MR2A-D and DEC-15-MR3A-D respectively. 



1.1.2 General I/O Communication 

A general communication required to accomplish an I/O task is the same for all three Monitor systems (see Figure 
1-1). A system or user program initiates an I/O function by means of a Monitor command (system macro), which is 
interpreted by a CAL handler within the Monitor as a legitimate I/O call. (See the PDP-15 Reference Manual 
DEC-15-BRZA-D for a description of the CAL instruction.) The I/O call includes a logical I/O device number as one 
of its arguments. The Monitor establishes the logical/physical I/O device association by means of its Device 
Assignment Table (.DAT). When this has been accomphshed, the Monitor passes control to the appropriate device 
handler subroutine to initiate the I/O function and returns control to the system or user program. The system or user 
program retains control until an interrupt (PI or API) occurs, at which time it relinquishes control to the device 
handler to perform and/or complete the specified I/O function. Computations or other processing can be performed 
by the system or user program while waiting for an interrupt. This feature allows the programmer to make optimum 
use of available time. 
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Figure 1-1 . General I/O Communication in Monitor Environment 



1.1.3 Command, Control, and Data Flow 

Figure 1-2 provides a more detailed representation of the Monitor environment, with emphasis on command, control, 
and data flow. As shown, the user can initiate a command via the Teletype which is interpreted by a Command 
Processor within the system program (or user program if so designed). 



Each system or user program must internally set up line buffers (except when using Dump mode, discussed later) to 
be used in transmitting data to or from the external environment. Each line buffer of n words consists of a two-word 
header (referred to as a header word pair) and n -2 words of data. The system or user program can exercise control on 
output by modifying the header word pair, or it can verify on input by examining the header word pair. The use of 
line buffers is discussed in more detail later in this chapter. 



Monitor I/O commands (system macros) are written as part of the system or user program. In FORTRAN IV source 
programs, these commands are in the form of READ and WRITE statements (refer to the PDP-15 FORTRAN IV 
Manual, DEC-15-KFZA-D). These statements are translated by the compiler into the proper calling sequences for the 
FORTRAN Object Time System which provides the required Monitor calls at execution time. In MACRO- 15 source 
programs. Monitor I/O commands are written as system macros within the system or user program. These system 
macros are expanded at assembly time and include a CAL initiated Monitor call that contains the logical device 
number as one of the arguments. 



At execution time, Monitor calls are processed by the CAL Handler within the Monitor. Non-I/O functions are then 
further processed by the Monitor Control routine and I/O functions are processed by the I/O Control routine (see 
Figures 1-2 and 1-3). A complete description of each of these commands is given in Chapter 2. If the original 
command involved is an I/O function, the I/O control routine checks the Device Assignment Table to associate the 
logical I/O device (specified by the system macro) to a physical I/O device. The logical/physical device associations 
can be modfied either by reassembly or with the aid of utility program PUNCH 15. 



When the logical/physical I/O device association has been established, the Monitor passes control to the appropriate 
I/O device handler which initializes itself, initiates I/O, and returns control to the system or user program. As 
mentioned previously, the system or user program retains control until the specified device causes an interrupt (PI or 
API). At this point, it relinquishes control to the device handler to continue or complete the specified I/O operation. 
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Functions processed 
by I/O control routine 



Functions processed by 
monitor control routine 



Function 
Code 

1 

2 

3 

4 

5 

6 

7 

10 
11 
12 
13 



14 
15 
16 
17 
20 



Command 
.INIT 

.DLETE, .RENAM, and .FSTAT 
.SEEK 
.ENTER 
.CLEAR 
.CLOSE 
.MTAPE 

.READ and .REALR 
.WRITE and .REALW 
.WAIT and .WAITR 
.TRAN 



.TIMER 

.EXIT 

.SETUP 

.IDLE and .IDLEC 

.RLXIT 



Figure 1-3. Monitor Commands and Function Codes 



NOTE 



.INIT, .READ, .WRITE, .WAIT, .WAITR, .CLOSE, .TIMER, and .EXIT are 

recognized by all three Monitors. 

.SEEK, .ENTER, .FSTAT, .RENAM, .DLETE, .TRAN, .CLEAR, and 
.MTAPE are recognized by the Advanced and Background /Foreground 
Monitors (and are ignored by the Basic I/O Monitor). 

.SETUP is used by the Monitors in setting up the I/O skip chain and API 
channel registers (see Chapter 4). 

.IDLE, .IDLEC and .RLXIT are recognized by the Background/Foreground 
Monitor only. 
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In either case, control is returned to the system or user program at the point where it was interrupted. The system or 
user program, by means of a .WAIT system macro (described in Chapter 2), can determine whether an input or output 
operation has been completed. If the transfer of data from or to the system or user program line buffer has been 
completed, program execution continues; if the transfer has not been completed, control is returned to the .WAIT 
macro. 

Additional buffering is provided by the individual device handlers as required. All device handlers are non-resident in 
the sense that only those handlers required by the system or user program are loaded into core. 



1.2 LINE BUFFERS 

As mentioned in the preceding general description of the Monitor environment, each system or user program must 
internally set up line buffers to be used in transmitting data to or from the external environment. An exception to 
this rule is when data is transmitted in the Dump mode (described in paragraph 1.3.1.4). Each line buffer of n words 
(always even) should be set up to consist of a two-word header (termed a header word pair) followed by n-2 words of 
data as shown in Figure 1-4. 



WordO 
Word 1 
Word 2 

1 

Word n- 1 



First Word of Line Buffer Header 



Second Word of Line Buffer Header 



First Word of Data Area 



Last Word of Data Area 



Figure 1-4. Line Buffer Structure 



A system or user program should contain at least one line buffer for each device that is to be used. This buffer is used 
to set up output lines before transmittal to an output device, or to receive input lines from the associated input 
device. The Monitor accepts commands (system macros) from system or user programs to initiate input to the line 
buffers and to write out the contents of line buffers. Complete descriptions of these commands are given in Chapter 
2. Line buffers are internal to, and must be defined by, each system or user program. The header word pair within a 
line buffer is detailed in Figure 1-5. The .BLOCK pseudo operation may be used to reserve space for a line buffer. A 
tag is required to allow referencing by individual .READ and .WRITE macros. For example: 

.DEC 



LINEIN 



.BLOCK 52 



/creates 52-word line 
/buffer named LINEIN. 



LINOUT 



.BLOCK 52 



/creates 52-word line 
/buffer named LINOUT. 



Before output, the user must set the appropriate word pair count in bits 1 through 8 of word zero in the line buffer if 
they have not already been set by a device handler on input. This count overrides the word count passed to lOPS by 
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HEADER. 
WORD 



1 = IGNORE CHECKSUM 
ON Bl NARY INPUT 



J" 



WORD PAIR COUNT, INCLUDING 
HEADER WORD PAIR 



FOR lOPS BINARY ONLY 
(CORRESPONDS TO 7-9 PUNCH 
ON BINARY CARDS) 



VALIDITY bits; 

00 = DATA CORRECT 

01 = PARITY ERROR 



I/O mode; 

0000 = lOPS BINARY 

000 1 = (MAGE BINARY 

001 = lOPS ASCII 

001 1 » IMAGE ALPHANUMERIC 



iCOUNT 
-LJ \ L 



I/O MODE 



J 



10 = CHECK SUM ERROR 
n = SHORT LINE 

(BUFFER OVERFLOW) 



0100 = DUMP 

0101 = EOF (LOGICAL)* 
0110= EOM (PHYSICAL)" 
111 = TAPE LABEL* 



->t lOPS AND IMAGE MODES ONLY 
XK ALSO DUMP MODE FOR 9 CHANNEL 
MAGNETtC 4 APES 



HEADER. 
WORD 1 



CHECKSUM: 



^r 



TWO'S COMPLEMENT OF HEADER WORD PLUS DATA 
WORDS (0= CHECKSUM NOT COMPUTED) 



Figure 1-5. Format of Header Word Pair 



the .WRITE macro. (The word count must still be specified in the .WRITE macro for each data mode; however, it 
only has meaning in Dump mode since there is no header word pair.) In lOPS binary mode (discussed in Paragraph 
1.3.1.2), bits 9 through 1 1 should be set to 101 if the output will ultimately be on cards. The checksum word, the 
second word in the header, need not be set by the user since checksums are computed by lOPS. 

Before input, the user should not be concerned with the header word pair since they will be set by lOPS to enable the 
user to determine what has happened after input has terminated. 

On input, the word count specified in the .READ macro is used by lOPS to determine the maximum number of 
locations to be occupied by the data being read. If the word count is exceeded before input is terminated, or if there 
is a parity or checksum error, lOPS sets the appropriate validity bits in header word to indicate the error. 

After input, the user should check the vahdity bits in word of the Hne buffer header to determine if the data was 
read without error. If multiple errors are detected, priority is given to a parity error over a checksum error. lOPS 
ignores checksum errors on binary input if bit of word of the line buffer header is set to 1 . lOPS sets the I/O 
mode bits (bits 1 4 through 1 7 of word of the line buffer header) to : 6 (0 1 1 O2 ) if it senses a physical end-of-medium 
(such as end-of-tape in the paper-tape reader), or 5 (OIOI2) if it senses a logical end-of-file during an lOPS binary 
read. 
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When choosing a word count (that is, the maximum line buffer size) to specify in system macros, both the set of 
possible devices and the mode of data transmission must be considered. The maximum line buffer sizes (including 
2-word header) for standard peripheral devices, along with applicable data modes, are listed in Table 1-1. 



Table 1-1. Maximum Line Buffer Sizes 



Device 


Maximum Line 
Buffer Size 


Data Modes* 


Notes 


PR (paper tape reader) 


52io 


All 


34io sufficient only if mode 2. Headers 
accepted for mode 0; generated for modes 1, 

2&3. 


PP (paper tape punch) 


52,0 


All 


34,0 sufficient only if mode 2. Headers 
output only for mode 0. 


TT (Teletype) 


34io 


2 & 3 only 


Allows for 80 1 o characters. 
Headers generated on input. 
Headers not output on output. 


CD (card reader) 


36io 


2 only 


Headers generated on input. 


LP (line printer) 


52io 


2 only 


Allows for 1 25 10 characters. No headers 
output. 


MTO-7 (magnetic tape) 


255io 


0, 2&5 


Modes and 2 allow for several line buffers 
(logical records) per physical block. 



*See paragraph 1 .3 below. 



1.3 DATA MODES 

The Input/Output Programming System allows data transmission to or from a system or user program in five different 
modes. 



Mode 


Code* 


lOPS Binary 





Image Binary 


1 


TOPS ASCII 


2 


Image Alphanumeric 


3 


Dump 


4 


9-Channel Dump 


5 



*Bits 14 through 17 of Header Word 0, specified by system macro and set by lOPS. 
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1.3.1 lOPS Modes 

The two lOPS data modes include lOPS ASCII and lOPS binary as shown in Figure 1-6 on paper tape, and described 
in the following paragraphs. 

TAPE CHANNEL 



DIRECTI ON 

OF TAPE 

MOVEMENT 



OOOOOoOOO 

ooooo oooo 

OOOOOOOOO 
OOOOOOOOO 



4^ 



lOPS ASCI I 



TAPE CHANNEL 



7-BtT ASCII CODE 

PARITY BIT (EVEN PARITY] 



DIRECT ION 

OF TAPE 

MOVEMENT 



• OOOOoOOO 

• OOOOoOOO 

• OOOOoOOO 

• OOOOOOOO 



i i 


k^ 


J 


r 










lOPS BINARY 





ist 6-BIT BYTE 
2nd 6-BIT BYTE 
3rd 6-BIT BYTE 



6-BlTS OF BINARY WORD 
PARITY BIT (ODD PARITY) 
MUST ALWAYS BE PUNCHED 



Figure 1-6. lOPS Mode Data on Paper Tape 



1.3.1.1 lOPS ASCII - 7-bit ASCII is used by lOPS to accommodate the entire 1 28-character revised ASCII set 
(Appendix A). All alphanumeric data, whatever its original form on input (ASCII, Hollerith, etc.) or final form on 
output, is converted internally and stored as 5/7 ASCII. "5/7 ASCII" refers to the internal packing and storage 
scheme. Five 7-bit ASCII characters are packed in two contiguous locations as shown in Figure 1-7 and can be stored 
as binary data on any bulk storage device. Input requests involving lOPS ASCII should be made with an even word 
count to accommodate the paired input. 

ASCII data is input to or output from lOPS ordinarily, via the Teletype or paper tape, although it may exist in 5/7 
ASCII form on any mass storage device. lOPS ASCII is defined as a 7-bit ASCII character with even parity in the 
eighth (high order) bit, in keeping with USA standards. lOPS performs a parity check on input of lOPS ASCII data 
prior to the 5/7 packing. On output, lOPS generates the correct parity. 

Non-parity lOPS ASCII occurs in data originating at a Model 33, 35, or 37 teletype, without the parity option. This 
data always appears with the eighth (high order) bit set to 1 . Apart from parity checking, the lOPS routines handle 
lOPS ASCII and non-parity lOPS ASCII data identically. 
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0-* ►'S 7-*— 


^13 14<4 ►> 17 


WORD 


1ST CHARACTER 


2ND CHARACTER 


3RD CHARACT 


17 














WORD 1 


3RD CHARACTER 
5-7 


4TH CHARACTER 


5TH CHARACTER 


-{ 



UNUSED 



Figure 1-7. 5/7 ASCII Packing Scheme 



An alphanumeric hne consists of an initial form control character (line feed, vertical tab, or form feed), the body of 
the line, and a carriage return (CR) or ALT MODE. CR (or ALT MODE) is a required line terminator in lOPS ASCII 
mode. Control character scanning is performed by some device handlers for editing or control purposes (see paragraph 
4.4 for effects of control characters on specific devices). 



1.3.1.2 lOPS Binary — lOPS Binary data is blocked in an even number of words, with each block preceded by a 
two-word header. On paper tape (see Figure 1-6), lOPS binary uses six bits per frame, with the eighth channel always 
set to 1, and the seventh channel containing the parity bit (odd parity) for channels 1 through 6 and channel 8. The 
parity feature supplements the checksumming as a data validity provision ifr paper tape lOPS binary. 



1.3.1.3 Image Modes - Image Mode data is read, written, and stored in the binary or alphanumeric form of the 
source or terminal device, one character per word, as shown in Figures 1-8 and 1-9. No conversion, checking, or 
packing is permitted, and character scanning is generally omitted. 

1.3.1.4 Dump Mode - Dump mode data is always binary. Dump mode is used to output from or load directly into 
any core memory area, bypassing the use of hne buffers. Each dump mode statement has arguments defining the core 
memory area to be dumped. Dump mode is normally used with bulk storage devices, although it is also possible to use 
it with paper tape output and input. 



1.3.1.5 9-Channel Dump Mode - This mode is always binary and is exclusively used with 9 channel magnetic tape 
transports. This mode is designed to take advantage of all 8 data bits in each frame of the tape and thus insure 
maximum thruput for each word transferred. A full discussion of this data mode is provided in paragraph 4.4.6. 



1 .3.2 Input/Output Data Mode Terminators 

Input/output terminators for each of the data modes are summarized in Table 1-2. 

1.4 SYSTEM TABLES 

System tables used by each of the monitor systems include the Device Assignment Table (.DAT), and the System 
Communication Table (.SCOM). These tables are discussed in the following paragraphs. 
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DIRECTION 

OF TAPE 

MOVEMENT 



DIRECT ION 

OF TAPE 

MOVEMENT 



TAPE CHANNEL 



ooooeooo® 
o®ooo«o©o 

©000®o©0© 
OOO0OCOOO 



^r 



L 



ALL EIGHT CHANNELS USED 
I MAGE ALPHANUMERIC 



TAPE CHANNEL 



• 0®0©oOO« 

• do©o«o«o 

• 0©06o©0® 

• »0®OeOOO 



i 4^ 



6-BIT BINARY CODE 
(3 FRAMES/WORD! 



MUST ALWAYS BE PUNCHED 



IMAGE BINARY 



Figure 1-8, Image Mode Data on Paper Tape 



n 



WORD COUNT 
17 



lOPS ASCII 



HEADER 
WORD PAIR 



ABC ^ 

IN 5/7 ASCII 



WORD COUNT 
8 17 



HEADER 
WORD PAIR 



ABC V 
FOUR 8-BIT 
>- CHARACTERS 
[RIGHT 
JUSTIFIED) 



(MAGE ALPHANUMERIC 



Figure 1-9. lOPS ASCII and Image Alphanumeric Data in Line Buffers 



1 .4. 1 Device Assignment Table (.DAT) 

Both FORTRAN IV and MACRO- 15 coded user programs, as well as the system programs, specify I/O operations 
with commands to logical I/O devices. One of the Monitor's functions is to relate these logical units to physical 



l-lO(Partlll) 



Table 1-2. Input/Output Data Mode Terminators 





lOPS 


lOPS 


Image 


Image 




9-Channel 




ASCII 


Binary 


Alphanumeric 


Binary 


Dump 


Dump 


1 


Carriage Return 


Word Pair Count 


Word Count 


Word Count 


Word Count 




N 
P 


ALT MODE 


End of Medium 


End of Medium 


End of Medium 


End of Medium 




U 

T 


Word Pair Count** 
End of Medium 
Word Count* 
End of File** 


Word Count* 
End of File** 


End of File** 


End of File** 


End of File** 


Word Count 




u 

T 
P 


Carriage Return 












ALT MODE 


Word Pair Count 


Word Pair Count 


\('ord Pair Count 


Word Count 


Word Count 


U 


Word Pair Count*** 












r 


(except on teletype) 













*A short Line Indicator will be placed by lOPS into the validity bits (12 and 13) of Header Word if the maximum size of the line 
buffer is reached before an End-of-File. 
**Bulk storage only. 
***If the word pair count is not greater than 1 , the output line is ignored. If the word pair count is greater than 1 , it has no effect and a 
carriage return or ALT MODE are the only legal line terminators. 

devices. To do this, the Monitor contains a Device Assignment Table (.DAT) which has "slot" numbers that 
correspond directly to logical I/O device numbers. Each .DAT slot contains the physical device unit number (if 
applicable) along with a pointer to the appropriate device handler. 

AH I/O communication in the Monitor environment is accomphshed by the logical/physical device associations 
provided by the Device Assignment Table (see paragraph 3.3.2). 

1.4.2 System Communication Table (.SCOiVl) 

The System Communication Table (.SCOM) provides a list of registers that can be referenced by the Monitor, lOPS, 
and system programs. A complete list of .SCOM entries, and the purpose of each, is given in Table 1-3. The System 
Communication Table begins at location lOOg . 

1.5 SPECIFYING DEVICES USED TO LINKING LOADER 

When writing a MACRO- 15 program that uses Monitor commands (system macros), it is necessary to use the .lODEV 
pseudo operation somewhere in the program to specify to the Linking Loader which .DAT slots are to be used. The 
.lODEV pseudo-op causes a code to be generated that is recognized by the Linking Loader and used to load device 
handlers associated with specified .DAT slots. FORTRAN IV programs cause the compiler to generate this code based 
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Table 1-3. System Communication Table (.SCOM) Entries 



Word 



Purpose 



.SCOM 
.SCOM + 1 
.SCOM + 2 
.SCOM + 3 
.SCOM + 4 



.SCOM + 5 
.SCOM + 6 



.SCOM + 7-1 1 



.SCOM+ 12-15i 
.SCOM+ 16 
.SCOM + 17 
.SCOM + 20 



First free register below resident portion of System Bootstrap (constant) 

First free register above resident Monitor (constant) 

First free register 

Last free register 

Hardware options available: 

Bit 1 = API 

Bit 1 1 = EAE 

Bit 2 1 = TTY is 35/37 

Bit 3 1 = Non-resident Monitor in core 

Bit 6 1 = 9-channel, = 7-channel Magnetic tape 

Bit 7 1 = Page Mode, ^ Bank Mode 

System program starting location 

User starting location (bits 3 through 17), and: 

Bit 1 = DDT Load 

Bit 1 1 = G Load 

Bit 2 1 = No-symbol-table Load 

Device numbers of Linking Loader's devices. These are used to avoid loading user handlers already 
in core for the Loader itself. 

Transfer vectors associated with API software level channel registers 40 through 438 • 

Contains PC on keyboard interrupts. 

Contains AC on keyboard interrupts. 

Bit 1 = 1 2K, 20K or 28K System 

Bit 3-17 = First Free Register in extra 4K Page 



on the units specified in READ and WRITE statements. If a variable is used in a FORTRAN program to specify an 
I/O unit, handlers will be loaded for all positive .DAT slots that have handlers assigned. The ,IODEV pseudo-op has 
the following form: 

.lODEV 3, 5,6 

where the MACRO-15 program containing this statement can use .DAT slots 3, 5, and 6. An error message is 
generated if a slot called for by a program is unassigned. The MACRO-15 Assembler Manual (DEC-15-AMZA-D) 
provides a full discussion of pseudo-ops. 
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CHAPTER 2 
USER PROGRAM COMMANDS (SYSTEM MACROS) 



User program commands or system macros that apply to the Basic I/O Monitor are described in this chapter for 
convenient reference. Because of the upward compatabiUty of Monitor systems, all I/O Monitor commands (system 
macros) are also used in the Advanced and Background/Foreground Monitor environments. 



NOTE 



When executing a system macro, the monitor makes no attempt to save the 
user's accumulator and link bit. 



2.1 BASIC 1/0 MONITOR COMMANDS {SYSTEM MACROS) 

The following commands are available for use in programs that are to operate in the Basic I/O Monitor environment. 
Each command is described in detail in the paragraphs that follow. 



Name 

.INIT 

.READ 

WRITE 

.WAIT 

.WAITR 

.CLOSE 



Purpose 

Initializes the device and device handler. 

Transfers data from the device to the line buffer. 

Transfers data from the line buffer to the device. 

Checks availability of the user's line buffer and waits if busy. 

Checks availabihty of the user's line buffer, and provides transfer 
address for busy return. 

Terminates use of a file. 
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Name 

.TIMER 

.EXIT 
2.2 INIT (INITIALIZE) 
FORM: 
VARIABLES: 



Purpose 

Calls and uses real-time clock. 
Returns control to the Monitor. 

.INIT a, F, R 

a = Device Assignment Table (.DAT) slot number (in octal radix) 



F = File Type: 



!■= 



= Input File 
Output File 



R = User Restart Address* (should be in every .INIT statement) 



EXPANSION: 



LOC 
LOC+ 1 

LOC + 2 
LOC + 3 



CAL + F7_8 +a9, 



R 



/The CAL handler will place the unit number (if 
/applicable) associated with .DAT slot a into bits 
/O through 2 of this word.** 



/Maximum size of line buffer associated with .DAT 
/slot a for example, 255 j o for DECtape.*** 



DESCRIPTION: The macro .INIT causes the device and device handler associated with .DAT slot a to be initialized. 
.INIT must be given prior to any I/O commands referencing .DAT slot fl; a separate .INIT command must be given for 
each .DAT slot referenced by the program. Each initialized .DAT slot constitutes an open file to the device handler 
and must be .CLOSEd. Since a .DAT slot may refer to only one type of file (input or output), only one file type 
specification (0 or 1) may be made in an .INIT statement. If a .DAT slot first references an input file, then an output 
file (or vice versa), a second .INIT command must be executed to change the transfer direction prior to the actual 
data transfer command. 
2.3 READ 



FORM: 



.READ a, M, L, W 



VARIABLES: 



a ~ .DAT slot number (octal radix) 



M = Data mode 



= lOPS Binary 

1 = Image Binary 

2 = lOPS ASCII 

3 = Image Alphanumeric 

4 = Dump Mode 



L = Line Buffer address 



W = Line buffer word count (decimal radix), including the two-word header 



^Has meaning only for .INIT commands referencing slots used by Teletype (the last .INIT command encountered for any slot 
referencing the keyboard or teleprinter takes precedence). When the user types CTRL P, control is transferred to R. For example, the 
Linking Loader takes advantage of this feature to restart the system when a new medium has been placed in the input device. 
**Has no direct effect upon the user's program, but should be noted so that no attempt will be made to use LOC + 1 as a constant. 
=**Size is returned by the handler so that the program, in a device-independent environment, can use it to properly set up line buffers. 
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EXPANSION: 



LOC 
LOC+ 1 

LOC + 2 

LOC + 3 



CAL + Mg-s +a9_i7 
10 



L 

.DEC 

-W 



/CAL Handler will place unit number (if applicable) 
/into bits through 2. 



/Decimal radix 



DESCRIPTION: The .READ command is used to transfer the next line of data from the device assigned to .DAT slot 
a to the line buffer in the user*s program. In the operation, M defines the mode of the data to be transferred; L is the 
address of the line buffer; and W is the number of words in the hne buffer (including the two-word header). 

Since I/O operations and internal data transfers may proceed asynchronously with computation, a .WAIT command 
must be used after a .READ command before the user attempts to use the data in the line buffer or to read another 
line into it. 

When a .READ (non-dump mode) has been completed, the program should interrogate bits 12 through 13 of the first 
word of the line buffer header to ascertain that the line was read without error. Bits 14 through 17 should be checked 
for end-of-medium and end-of-file conditions. 



2.4 .WRITE 

FORM: 

VARIABLES: 



EXPANSION: 



WRITE a, M,L,W 

a = .DAT slot number (octal radix) 

= lOPS Binary 

1 = Image Binary 
M= Data mode \ 2 = lOPS ASCII 

3 = Image Alphanumeric 

4 = Dump Mode 

L = Line buffer address 

W = Line buffer word count (decimal radix), including the two-word header 



LOC 
LOC+ 1 

LOC + 2 

LOC + 3 



CAL + M6_8 + a9-i7 



1^ 

L 

DEC 
-W 



/CAL Handler will place the unit number (if appli- 
/cable) associated with .DAT slot a into bits 
/O through 2. 



/Decimal radix 
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DESCRIPTION: .WRITE is used to transfer a line of data from the user's line buffer to the device associated with 
DAT slot a. 

WAIT must be used after a .WRITE command, before the line buffer is used again, to insure that the transfer to the 
device has been completed. 

On non-bulk storage devices, headers are output along with the data in lOPS binary mode only (bit 9 and 1 1 of 
header word should be set to 1). On bulk storage devices, headers are output along with the data in all modes except 
dump mode. In image modes, the header space cannot be used for data, even though the headers are not written out. 
The word pair count in the header takes precedence over maximum size (or word count) in all modes and must be 
inserted by the user. 

For both .READ and .WRITE macros, dump mode causes the transfer of the specified core area to or from one record 
on magnetic or paper tape. One or more blocks on DECtape or disk may be occupied by a single dump command. A 
subsequent .WRITE in dump mode will utilize the unfilled portion of the last block. 



2.5 .WAIT 



FORM: 



WAIT a 



VARIABLES: 



a = .DAT slot number (octal radix) 



EXPANSION: LOG 

LOC + 



l^Aij T ag— J 'y 



12 



/The CAL Handler will place the unit number (if 
/applicable) associated with .DAT slot a into bits 
/O through 2. 



DESCRIPTION: .WAIT is used to detect the availability of the user's line buffer (being filled by .READ or emptied 
by .WRITE). If the line buffer is available, control is returned to the user immediately after the .WAIT macro 
expansion (LOG + 2). If the transfer of data has not been completed, control is returned to the .WAIT macro. .WAIT 
must also be used after the .TRAN command. 



2.6 .WAITR 

FORM: WAITR a, ADDR 

VARIABLES : a = .DAT slot number (octal radix) 

ADDR = Address to which control is passed if line buffer is not available for use. 
EXPANSION: LOC CAL + 1 OOOg + a^.j ^ 



LOC+ 1 



12 



/The CAL Handler will place the unit number (if 
/applicable) associated with .DAT slot a into bits 

/O through 2. 



LOC + 2 



ADDR 
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DESCRIPTION: .WAITR is also used to detect the availability of the user's line buffer. If the buffer is available, 
control is returned to the user immediately after the .WAITR macro expansion (LOC + 3). If the transfer of the data 
has not been completed, however, control is given to the instruction at ADDR. It is the user's responsibility to return 
to the .WAITR to again check the availability of the buffer. 



2,7 .CLOSE 

FORM: 

VARIABLES: 



.CLOSE a 

a = .DAT slot number (octal radix) 



EXPANSION: LOC 

LOC+ I 



CAL + 39-17 



/The CAL Handler will place the unit (if applicable) 
/associated with .DAT slot a into bits through 2. 



DESCRIPTION: When action has been initiated (.INIT or .SEEK or .ENTER) on a file (whether the device is 
file-oriented or not) this action must be terminated by a .CLOSE command. 

On input, it is assumed that the user is finished with the file when the .CLOSE macro is used, so the file is closed. On 
output, all associated output is allowed to finish and then an EOF (end-of-file) line is output before the file is finally 
closed. If a refers to a file-oriented device, any earUer file of the same name and extension, as currently referenced, is 
deleted from its directory after the new file is written. 



2.8 .TIMER 

FORM: 

VARIABLES: 

EXPANSION: 



TIMER n,C 

n = Number of clock increments (decimal radix) 

C = Address of subroutine to handle interrupt at end of interval 

LOC CAL 

LOC+1 14 

LOC + 2 C 

.DEC /Decimal radix 

LOC + 3 -n 



DESCRIPTION: .TIMER is used to set the real-time clock to n increments and to start it. Each clock increment 
represents l/60s for 60 Hz systems and l/50s for 50 Hz systems. 

C + 1 is the location to which control is given when the Monitor services the clock interrupt. The coding at C should 
be in subroutine form; for example, 
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XIT 



/C + 1 is reached via JMS 

DAC SAVEAC 

Must not contain any Monitor CALs 
^ in Basic or Advanced Software Systems 
LAC C /Restore Link 

RAL 

LAC SAVEAC /Restore AC 
JMP*C 



so that control will return to the originally-interrupted sequence when the interval-handling routine has been 
completed. The Monitor automatically reenables the interrupt system before transferring control to C + 1. If the user 
wishes to initiate another interval at the completion of the previous interval in the subroutine specified to .TIMER, he 
may do so as follows: 

LAC (desired interval in 2's complement) 

DAC* (7 

LAC C /Restore Link 

RAL 

LAC SAVEAC /Restore AC 

CLON /Turn on clock 

JMP*C 



2.9 .EXIT 




FORM: 


.EXIT 


EXPANSION: 


LOC 



LOC+ 1 



CAL 



15 



DESCRIPTION: .EXIT provides the standard method for returning to the Monitor after completion of a system or 
user program. In the Basic I/O Monitor environment, it causes a program halt; in the Advanced Monitor environment, 
it causes the non-resident monitor to be reloaded. When the reloading process has been completed, the Monitor types 

MONITOR 



on the teleprinter, indicating that it is ready to accept the next command. In the Background/Foreground Monitor 
environment, the effect of the .EXIT depends upon whether it occurs in a BACKGROUND or a FOREGROUND job. 
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CHAPTER 3 
BASIC INPUT/OUTPUT MONITOR FUNCTIONS 



3.1 GENERAL 

The Basic I/O Monitor simplifies the programming of input and output functions in the basic paper-tape environment. 
It serves as an interface between the system and user programs and the external world of device hardware, relying 
upon the routines and capabilities of the Input/Output Programming System (lOPS) to relieve the programmer of 
writing his own device and data handling subroutines. The I/O Monitor allows simultaneous operation of many I/O 
peripherals and overlapped computation. Since upward compatibility exists between the Monitor systems, user 
programs that are written to operate under control of the I/O Monitor will also operate, without modification, under 
control of the Advanced and Background/Foreground Monitors. 



The Input/Output Monitor is designed to take advantage of the Automatic Priority Interrupt (API) if it is present on 
the system. Both the I/O skip chain for the Program Interrupt Control (PIC) and the API channels are set up to 
handle all devices which have been requested by the user. All unused channels are tied to an error routine to detect 
spurious interrupts. 



The reader is referred to Chapter 1 for a general discussion of the Monitor environment, and to Chapter 2 for detailed 
descriptions of user program commands (system macros) available in the I/O Monitor environment. 



3.2 PROGRAIVliVIING EXAMPLE 

The following example illustrates the use of system macros with MACRO-15 programs in the Basic I/O Monitor 
environment. The example inputs a line of data from the Teletype keyboard, and outputs the same hne of data to the 
Teletype. The arguments used by the system macros are given symbolic names (via MACRO-15 direct assignment 
statements) to facilitate recall for the programmer, and to change the arguments easily, if desired. Note the use of the 
pseudo-ops. .TITLE, .lODEV, .BLOCK, and .END, in addition to the system macros. The assembly listing that 
follows the example shows how the system macros are expanded at assembly time. (The reader may wish to compare 
these expansions with the system macro descriptions in Chapter 2.) 
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.TITLE 


ECHO 




UlzZ 








TT0 = 4r.^ 








OUTzi 








IN = 








lOPozZ 










.lOUEV 


Z,A 




STAfiT 


.INIT 


TTO,OUT,RESTRT 


/itaTlALIZE 




.INIT 


TTI,IN,H£STRT 


/ANU INPUT 


dtull^ 


.hEAD 


TTI,I0PS,£iUFFEh,34 


/INPUT lOPS 




.WAIT 


TTl 


/WAIT UNTIL 




.WRITE 


TT0,I0PS,dUFFEH,34 


/OUTPUT SAi"*lE 




.WAIT 


TTO 


/WAIT UNTIL 




J rtP 


BEGIN 


/LOOP TO INP 


htSTHT 


.CLOSE 


TTI 


/TERi'llNATE I 




.CLOSE 


TTO 


/TERillNATE 




J.'iP 


START 


/RETURN TO R 


dUffKH 


.BLOCK 


42 


/SET UP TELE 




.END 


START 


/END OF ECHO 



TELETYPE OUTPUT 

ASCII FROil TELETYPE 
INPUT COilPLETE 

DATA ON TELETYPE 
OUTPUT COMPLETE 
UT AGAIN 
NPUT 
UTPUT 

EINITIALIZE 
TYPE BUFFER (34 DEC) 

PROGRArO 



ASSEMBLY LISTING: 

PAGE 1 ECHO 



.TITLE ECHO 



t^0C^002 A 

[^00410 A 

0P30001 A 

C^0(^000 A 

00P1002 A 

00000 R 

00000 R 00l4l0 A «G 

00001 P 000001 A «G 

00002 R 000025 R «G 
00005 R 000000 A itQ 



00004 

00005 
00006 
00007 

010 
00010 
00011 
0001? 



000002 

000001 

000025 
00 

20 2 
010 
3 2 



*G 
*G 
»G 
»G 

^^G 
«G 

»G 



00013 R 777736 A ttG 

00014 R C''00002 A ^^G 

00015 R ^00012 A >G 

00016 R 002410 A »G 

00017 R 000011 A *G 

00020 R 000032 R *G 

00021 R 777736 A »G 



TTI=2 
TTO=410 
0UT = 1 
IN = 
I0PS=2 

START 



BEGIN 



.lODEV 2,4 

. INIT TT0,0UT,ReSTRT 

CAL+OUT*l000 TT0fi777 

1 

RESTRT+0 



.INIT TTKIN,RESTRT 

CAL+IN*1000 TTU777 

1 

RESTRT+0 



.RFAD TTI,I0PS,B^rFER,34 

CAL+IOPS»i000 TTI^777 

10 

BUFFER 

.DEC 

-34 

.WAIT TTI 

CAL TTI&777 

12 

.^JPITe TTCIOPS, buffer, 34 

CAL+IOPS*i000 TTO5777 

11 
BUFFER 

.DEC 

-34 

.WAIT TTO 
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m7\22 


R 


{^100410 


A 


»G 


00023 


R 


000012 


A 


«G 


00024 


R 


600010 


R 




00025 


R 








00025 


R 


00 2 


A 


*G 


00026 


R 


000^06 


A 


»G 


00027 


R 


000410 


A 


^»G 


00030 


R 


06 


A 


*G 


00031 


R 


6001/100 


R 




0003? 


R 


000000 


A 
R 





CAL TT0S777 
12 

JMP REGIN 
RESTRT .CLOSE TTI 
CAL TTU777 
6 

.CLOSE TTO 
CAL TT0S777 
6 
JMP START 

BUFFER .BLOCK 42 

.EMD START 
ERROR LINES 



PAGE 



ECHO 



BEGIN 


00010 


R 


RUFFER 


00032 


R 


IN 


000000 


A 


lOPS 


000002 


A 


OUT 


000001 


A 


RESTRT 


00025 


R 


START 


00000 


R 


TTI 


000002 


A 


TTO 


000410 


A 


PAGE 3 


ECHO 


IN 


000000 


A 


START 


00000 


R 


OUT 


000001 


A 


TOPS 


000002 


A 


TTI 


000002 


A 


BEGIN 


00010 


R 


RESTRT 


00025 


R 


RUFFER 


00032 


R 


TTO 


000410 


A 



3.3 OPERATING THE BASIC I/O MONITOR SYSTEM 

The reader is referred to the PDP- 15/10 Users Guide (DEC-15-GG1A-D) for detailed operating procedures for system 
programs in the I/O Monitor environment. The followmg PDP- 15 Software System manuals contain additional 
detailed information on system programs. 



Manual 

Utility Programs 
MACRO-1 5 Assembler 
FORTRAN IV 
FOCAL 
8TRAN 



Document Number 

DEC-15-YWZA-D 

DEC-15-AMZA-D 

DEC-15-KFZA-D 

DEC-15-KJZA-D 

DEC-15-ENZA-D 



This section contains descriptions of loading programs, device assignments, and error detection and handling. 
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3.3.1 Loading Programs in the Basic I/O Monitor Environment 

In the paper tape system, each system program accompanied by the necessary I/O device handlers and an appropriate 
version of the Monitor, is punched on a separate paper tape in absolute format. See Figure 3-1 for memory maps of 
the Basic I/O Monitor System. 

The eleven system tapes supplied are: 

FORTRAN IV DDT (without Patch File capabihties) 

FOCAL- 1 5 DDT (with Patch File capabilities) 

MACRO- 1 5 8TRAN (PDP-8 to PDP-1 5 Translator) 

PIP- 15 CHAIN 

Text Editor EXECUTE 
Linking Loader 



In addition, the utility program PUNCH-15 which provides the abiUty to dump an executable core load and .ABS 
loader onto paper tape, is provided with all paper tape systems. 

At the beginning of each tape is a Bootstrap Loader in hardware READIN mode. By setting the starting address of the 
Loader on the console ADDRESS switches to 17720 (8K), depressing I/O RESET, and then depressing the READIN 
switch, these system tapes may be loaded. 



Since the tapes also contain appropriate versions of the Basic I/O Monitor and the necessary I/O device handlers, the 
system programs listed above can be loaded, ready for operation, in a single step. 

Once the system program has been loaded and takes control, the individual system program operating procedures 
come into use. (See PDP-15/10 Users Guide, DEC-15-GG1A-D.) 



User programs, however, normally exist in relocatable form, as output from FORTRAN IV or MACRO-15, these 
tapes do not contain copies of the Monitor, To load these programs, the Linking Loader or DDT should be loaded 
first. The user should then initiate loading of his main program followed by all required subprograms. By loading 
subprograms in order of size (largest first, smallest last), the user has a better chance of satisfying core requirements 
for his program in systems with extended core memory. The Monitor (including the device handlers) contained on the 
Linking Loader or DDT tape may be used with user programs, and the Linking Loader or DDT can be used to load 
the necessary device handlers as well as the user's object programs. 
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MEMORY MAP A SY STEM PROGR AMS 



4K TO 32K 
(4K INCREMENTS) 



BOOTSTRAP 

LOADER IN 

HRM FORMAT 



SYSTEM 
PROGRAM 



SYSTEM 

PROGRAM 

TABLE 

SPACE 



SYSTEM PROGRAM 
DEVICE HANDLER 



SYSTEM PROGRAM 
DEVICE HANDLER 



I/O MONITOR 

WITH TELETYPE-IN 

AND 

TELETYPE-OUT 

DEVICE HANDLERS 



FORTRAN H 

MACRO- 15 

EDITOR 4K TO 32K 

PIP-15 {4K INCREMENTS) 



MEMORY MAPB-LINKING LOADER. CHAIN 



48 



10 



• SCOM 



• SCOM +3 



• SCOM + 2 



• SCOM + I 



880,0 



BOOTSTRAP 

LOADER IN 
HRM FORMAT 



USER 
PROGRAMS 
FOCAL- 15 
AND 8TRAN 



GLOBAL 
SYMBOL 
TABLE 



L IN K ING LOADER 
OR CHAIN 



PAPER TAPE 
READER HANDLER 



I/O MONITOR 

WITH TELETYPE-IN 

AND 

TELETYPE -OUT 

DEVICE HANDLERS 



48,0 
• SCOM AND • SCOM +3 



• SCOM + 2 



• SCOM + 1 



880, 



NOTE : 

IN THE CASE OF CHAIN THE 
PAPER TAPE PUNCH HANDLER 
IS ALSO RESIDENT IN CORE. 



Refer to Section 4.4 for sizes for device 
handlers. 



Refer to Memory Map D for results of Linking 
Loader 



Figure 3-1 . BASIC I/O Monitor System Memory Maps 



3-5(Part III) 



MEMORY MAP C-DDT TAPE 



4K TO 32K 
(4K INCREMENTS) 



BOOTSTRAP 

LOADER IN 

HRM FORMAT 



DDT 



USER 
PROGRAMS 



GLOBAL AND 

DDT 

SYMBOL TABLES 



UNKING 
LOADER 



PAPER TAPE 
PUNCH HANDLER 



PAPER TAPE 
READER HANDLER 



I/O MONITOR 

WITH TELETYPE-IN 

AND 

TELETYPE-OUT 

DEVICE HANDLERS 



48io 
• SCOM 



• SCOM + 3 



• SCOM +2 



• SCOM -1-1 



860 



10 



MEMORY MAP D-USER PROGRAM READY 
TO BE EXECUTED 



4K TO 32 K 
(4K INCREMENTS) 



BOOTSTRAP 



USER 
PROGRAM(S) 



USER DEVICE 
HANDLER 



USER DEVICE 
HANDLER 



USER DEVICE 
HANDLER 



LINKING LOADER 
DEVICE HANDLER 



LINKING LOADER 
DEVICE HANDLER 



I/O 

MONITOR 

(INCLUDING 

TELETYPE 

HANDLER) 



48,0 



SCOM 



• SCOM +3 



(a) 



^10 



Refer to Memory Map E for results of Link 
Loading in DDT mode. 

Paper Tape Punch Handler is only present in 
DDT versions with patch file capabilities. 

Refer to Section 4.4 for sizes of device handlers. 

.SCOM+1 and .SCOM+2 both point to one of 
two places and non-BLOCK DATA COMMON 



(FORTRAN IV or MACRO-15) output may 
make use of core as low as they point. 

a. If the user program did not have any device 
handlers in common with the Linking 
Loader. 

b. If the user program did have at least one 
device handler In common with the Linking 
Loader. 



Figure 3-1. BASIC I/O Monitor System Memory Maps (Cont) 
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MEMORY MAP E 



MEMORY MAP F (EXECUTE) 



4K TO 32K 
{4K INCREMENT) 



BOOTSTRAP 



USER 
PROGRAM (S) 



USER/ DDT 
DEVICE HANDLER 



USER/DDT 
DEVICE HANDLER 



DDT CREATED 
SYMBOLS AND 
PATCH SPACE 



DDT 
SYMBOL 

TABLE 



4K TO 32K 
(4K INCREMENTS) 



50 



10 



SCOM 



• SCOM + 3 



• SCOM +2 



/////////////J// 



LINKING LOADER 
DEVICE HANDLER 



LINKING LOADER 
DEVICE HANDLER 



I/O MONITOR 

(INCLUDING 
TELETYPE 
HANDLER) 



• SCOM + 1 



LINKING LOADER 
BLOCK TRANSFER 
ROUTINE 



eeoio 



BOOTSTRAP 



EXECUTE 



USER 
PROGRAM(S) 



LIBRARY 
PROGRAM(S) 



USER DEVICE 
HANDL£R(S) 



NAMED COMMON 



BLANK COMMON 



EXECUTE'S 
DE V ICE 
HANDLER 



I/O MONITOR 

( INCLUDING 

TELETYPE 

HANDLER ) 



48i0 



• SCOM 
352,0 



• SCOM-l-3 



• SCOM+2 



880,0 



Refer to Section 4.4 for sizes for device 
handlers. 

Non BLOCK DATA COMMON {FORTRAN IV 
of MACRO-15 output) may make use of core as 
low as the DDT symbol table. However, trouble 
will occur if the user requests DDT to create 
symbols or make patches that cause overlaying 
of the COMMON area. 

The Linking Loader device handlers would have 
been used to satisfy user device requests. 



When the user types in the name of the XCT 
File to be run, .EXECUTE brings in the first 
chain from paper tape. 

FORTRAN programs pass on data in blank 
common starting at .SCOM + 2. Macro programs 
pass on data between .SCOM + 2 and .SCOM + 
3. 

A call from the running chain to bring in 
another chain is effected by transferring control 
back to Execute. 



Figure 3-1 . BASIC I/O Monitor System Memory Maps (Cent) 
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3.3.2 Device Assignments 

The device assignment table used by the Basic I/O Monitor is fixed in length and in the assignments it contains. It is 
composed of two sections; the upper section is for use by all system programs except PIP, the lower section is 
referenced by all user programs and PIP. 

The upper portion of the .DAT contains 13 slots, referenced as -1 through -15,. The lower section has 8 slots 
numbered 1 through lOg. The standard assignments for the device assignment table for user programs and system 
programs other than PIP are shown in Figure 3-2. Figure 3-3 illustrates PIP assignments, which include the Card 
Reader (CR03B) and Line Printer as standard devices. 



.DAT Slot 

.DATBG -15 

-14 

-13 
-12 
-11 
-10 



-7 
-6 

-5 
-4 

-3 
-2 
-1 

.DAT 
1 

2 
3 
4 
5 
6 
7 
10 



DAT 



DATND^ 



Device 

Paper Tape Punch 
Paper Tape Reader 
Paper Tape Reader 
Paper Tape Punch 
Paper Tape Punch 
TTY Printer 
Paper Tape Reader 
Paper Tape Reader 

TTY Keyboard 



Paper Tape Punch 



Paper Tape Reader 

TTY Printer 
TTY Keyboard 
Paper Tape Reader 



TTY Printer 
TTY Keyboard 
Paper Tape Reader 
TTY Printer 
Paper Tape Punch 
Paper Tape Reader 
Paper Tape Punch 
Paper Tape Reader 



Handler* 

(PPA.) 

(PRA) 

(PRA.) 

(PPA) 

(PPB.) 

(TTA.) 

(PRB.) . 

(PRA.) 

(TTA,) 

(PPA.) 

(PRA.) 

(TTA.) 
(TTA.) 
(PRA.) 



(TTA.) 

(TTA.) 

(PRA.) 

(TTA.) 

(PPA.) 

(PRA.) 

(PPA.) 

(PRA.) 



Use 

Editor Output 

8TRAN Input 

Editor Input 

8TRAN Output 

MACRO, FORTRAN IV Output 

MACRO, FORTRAN IV Listing 

MACRO, FORTRAN IV Input 

DDT Patch-file Input and 

Editor Secondary Input 

MACRO Secondary Input 

Not Used 

Output (.DDT, Chain) 

Not Used 

System Input (Linking Loader, 

DDT Chain and Execute) 

Teleprinter Output 

Keyboard Input 

System Device (Linking Loader, 

DDT and Chain) 

Teleprinter Output 

Keyboard Input 

Input 

Listing 

Output 

Scratch 

Scratch 

Scratch 



Figure 3-2. Device Assignment Table (.DAT) for the Basic I/O Monitor 

The negative .DAT slot assignments for use by system programs may be changed by DEC. For example, .DAT slot -10 
might be associated with a card reader, while .DAT slot -12 could be assigned to a line printer. Provision for changing 
positive .DAT slot assignments for use by relocatable user programs is included in the PUNCH 15 utility program (see 
section 3.3.5). For example, a line printer handler (LPA) or a card reader handler (CDB) could be added. 

*See Section 4.4 for a description of the handlers. 
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DAT Slot 


Device 


Handler 


Use 


I 


Teletype 


(TTA.) 


Input/Output 


2 


Teletype 


(ilA.) 


Input/Output 


3 


Paper Tape Reader 


(PRA.) 


Input 


, 4 


Line Printer 


(LPA.) 


Output 


5 


Paper Tape Punch 


(PPA.) 


Output 


6 


Card Reader 


(CDB.) 


Input 


7 


Paper Tape Punch 


(PPA.) 


Output 


10 


Paper Tape Reader 


(PRA.) 


Input 



Figure 3-3. Device Assignment Table (.DAT) for PIP 



3.3.3 Error Detection and Handling 

Comprehensive error checking is provided by the Linking Loader and the Input/Output Programming System. 
Detailed lists of errors that may occur are given in Appendix C and D, respectively. The other system programs also 
provide comprehensive error checking. Refer to the appropriate PDP-15 manual (see paragraph 1.3 in Part I of this 
manual). 

3.3.4 Control Character Commands in the Basic I/O Monitor Environment 

All control character commands recognized by the Basic I/O Monitor are summarized in Table 3-1. These commands 
(except RUBOUT) are formed by holding down the CTRL key while striking a letter key. The character or characters 
echoed on the Teletype and the resulting action is given in the table for each command. 

3.3.5 Modifying System Programs and Building Executable User Core Loads in the Basic I/O Monitor Environment 

The capability of modifying or patching system programs in the Basic I/O Monitor environment is provided by the 
utility program PUNCH 15. PUNCH 15 allows for producing an executable core load on paper tape in .ABS format 
with the standard .ABS loader (HRM 17720 of the highest available core bank) on the front of the tape. This is 
particularly useful when the core load consists of a relocatable main program, subroutines and library routines, the 
repetitive loading of which tends to be time consuming. It is further possible to specify the number of .ABS tapes to 
be output (1-9) for convenience of tape handling. 

The areas of memory output by PUNCH 15 are up to .SCOM + 2 (the first free cell) and .SCOM + 3 (last free cell) 
up to the .ABS loader (17720 modulo 8K). PUNCH 15 is loaded (I/O RESET and READIN) at 17720 of the highest 
core bank available. It loads and relocates part II of itself in free core, i.e., from the cell in .SCOM + 2 and up. When 
loaded it types the following message on Teletype: 

P, T or S?^ 

> 
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Table 3-1 . Control Character Commands 



Command 


Echo 


Action 


CTRLS 


t S 


Starts user program after Linking Loader has brought it into core via a 
LOAD command. 


CTRL! 


tT 


CTRL T is applicable only when using DDT and transfers control to 
DDT which types 

DDT 

> 

to indicate its readiness for another DDT command. All previous DDT 
conditions remain intact (breakpoints, register modifications, etc.). 


CTRLR 


tR 


Allows the user to continue when an I0PS4 (device not ready) error 
occurs. The user must first ready the device, and then type CTRL R. 


CTRLP 


tP 


Forces control to last address specified in the .INIT command 
referencing Teletype. Used by system programs to reinitialize or restart. 


CTRLD 




Generates EOT code — used to terminate Teletype input. 


CTRLU 


@ 


Cancels current line on Teletype (input or output). 


RUBOUT 


\ 


Cancels last character input from Teletype (not appHcable with DDT). 



The user is expected to type CTRL P or CTRL T or CTRL S to define the starting location of the program to be 
punched followed by carriage return (1 tape) or a number (1-9) specifying the total number of tapes into which 
binary output is to be divided. 

All tapes output by PUNCH 15 are loaded by pressing I/O RESET and the READIN key with ADDRESS switches set 
to 17720 of the highest core bank. 

CTRL T should be used if DDT is part of the core load. 

CTRL P should be used for all other system programs and user programs which have already initialized (.INIT) the 
teletype with a restart address at the time PUNCH 1 5 was executed. 

CTRL S should be used only if the core load was output by PUNCH 1 5 after Linking Loader operation at the 
moment when the loader itself was expecting the CTRL S command. 

All tapes output by PUNCH 1 5 are loaded by pressing I/O RESET and the READIN key with ADDRESS switches to 
17720 of the highest core bank. 



3.3.6 Modifying User .DAT Slots in the I/O Monitor Environment 

Although it is not possible to reassign negative .DAT slots at load time in the Basic I/O Monitor environment for 
system programs (reassembly is required), PUNCH 1 5 provides this capability for the user or positive .DAT slots. 
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For example, Figure 3-2 lists the standard .DAT slot assignments, A relocatable user program wanting to use a card 
reader (CDB.) or line printer (LPA.) whose handlers are included in the paper tape library has no way of doing so 
unless the positive .DAT table can be modified. The modification procedure is as follows: 

1 . Load the Linking Loader (or DDT) tape into core (HRM 17720 modulo 8K). 

2. Stop the computer and modify the appropriate .DAT slot cell* according to the Loader-I/0 correspondence 
table below. For example, if .DAT slot 7 is to be assigned to the hne printer using handler LPA, cell 144 should be 
changed to 000007. 

3. Load PUNCH into core (HRM 17720 modulo 8K). 

4. Type CTRL P in response to the query from PUNCH: P, T or S? 

5. Load the resultant punched tape into core (HRM 17720 modulo 8K). 

6. The Loader will restart ready for acceptance of typed program names to be loaded. If .DAT slot 7 is referenced 
by the user program (e.g., lODEV 7), LPA for the line printer will be loaded from the I/O Library. 

Loader - I/O Correspondence 

Handler .DA T Slot Value 



TTA. 
PR A. 
PRB. 
PPA. 
PPB. 
PPC. 
LPA. 
CDB. 
MTF 



1 

2 

3 

4 

5 

6 

7 
11 
13* 



*.DAT table (cell 0) begins at location 135 
**With unit number in bits 0-2. 
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CHAPTER 4 
I/O DEVICE HANDLERS 



This chapter contains information that is essential for a good understanding and proper use of I/O device handlers for 
the Basic I/O Monitor system. Included is a general description of I/O hardware and API software level handlers, a 
complete section on writing special I/O device handlers, a summary of I/O handlers acceptable to system programs, 
and a summary of standard I/O handler features. 

It is assumed that the reader is familiar with all related material in the PDP-15 Reference Manual (DEC-15-BRZA-D), 
especially Chapter 5, Organization of the Input/Output Processor. It is also assumed that the reader is familiar with 
the PDP-15 Monitor environment and other pertinent information contained in this manual 



4.1 DESCRIPTION OF I/O HARDWARE AND API SOFTWARE LEVEL HANDLERS 



4. 1. 1 I/O Device Handlers 

All communications between user programs and I/O device handlers are made via CAL instructions (see Chapter 2) 
followed by argument lists. The CAL Handler in the Monitor performs preliminary setups, checks on the CAL calling 
sequence, and transfers control via a JMP instruction to the entry point of the device handler. When the control 
transfer occurs, the AC contains the address of the CAL in bits 3 through 1 7 and bits 0, 1 , and 2 indicate the status of 
the Link, extend mode and memory protect, respectively, at the time of the CAL. Note that the content of the AC at 
the time of the CAL is not preserved. 

On machines that have an API, the execution of a CAL instruction automatically raises the priority to the highest 
software level (level 4). Control passes to the handler while it is still at level 4, allowing the handler to complete its 
re-entrant procedures before debreaking (DBK) from level 4. This permits the handler to receive re-entrant calls from 
software levels higher than the priority of the program that contained this call. If a device handler does not contain 
re-entrant procedures, system failure caused by inadvertent re-entries can be prevented by remaining at level 4 until 
control is returned to the user. 

If the non-reentrant method is used, the debreak and restore (DBR) instruction should be executed just prior to the 
JMP* which returns control to the user, allowing debreak from level 4 and restoring the conditions of the Link, 
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extend mode, and memory protect. Any lOTs issued at the CAL level (level 4 if API present, mainstream if no API) 
should be executed immediately before the 

DBR 
XCT .+ 1 
JMP* 

exit sequence to ensure that the exit takes place before the interrupt from the issued lOT occurs. (The XCT is 
necessary to ensure that the 3 cycles requested by the API on a debreak operation occur in the instruction after the 
DBR.) 

The CAL instruction must not be used at any hardware priority level (API or PIC), since interrupts to these levels are 
not closed out by the execution of a CAL and recovery is not possible from such sequences of events as 

a. An I/O flag coming up during a CAL at level 7, 

b. Control going to the I/O device handler at level 3, 

c. The handler at level 3 CALing and thus destroying the content of location 00020 for the previous CAL. 

The highest API software level (level 4) is also used for processing CALs and care must be taken when executing CALs 
at this level. For example, a routme that is CAL'd from level 4 must know that if a debreak (DBR or DBK) is issued, 
control will return to the calling program at a level lower than 4. The calling routine will also debreak; however, this 
second debreak will not be from level 4 but from the next highest active level. 



4. 1 . 1 . 1 Setting Up the Skip Chain and API (Hardware) Channel Registers When the Monitor is loaded, the Program 
Interrupt Control (PIC) skip chain and the Automatic Priority Interrupt (API) channels are set up to handle the 
Teletype keyboard, teleprinter and clock interrupts, only. The skip chain contains the other skip lOT instructions, 
but indirect jumps to an error routine result if a skip occurs, as follows: 

/Skip if Reader flag. 

/INT 1 contains error address. 
/Skip if line printer flag. 

/INT2 contains error address, 
/Skip if Teletype flag. 

/To Teletype interrupt handler. 



SKP 


PRA 


SKP 




JMP* 


INITl 


SKP 


LPT 




SKP 


JMP* 


INT2 


SKP 


TTl 


SKP 




JMP 


TELINT 



Ail unused API channels also contain JMPs to the error address. 

When a device handler is called for the first time via an .INIT user program command, it must call a Monitor routine 
(.SETUP) to set up its skip chain entry or entries and API channel, prior to performing any I/O functions. The calling 
sequence is as follows. 
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CAL 



16 
SKP 

DEVINT 
(normal return) 



N 



lOT 



/N = API channel register 40 through 77 (see section 
/4.1.3 for standard channel assignments), if device 
/not connected to API. 
/.SETUP function code. 
/Skip lOT for this device. 
/Address of interrupt handler. 



DEVINT exists in the device handler in the following format. 



DEVPIC 


DAC 


DEVAC 




LAC* 


(0 




DAC 


DEVOUT 




LAC 


DEVION 




JMP 


DVSTON 


DEVINT 


JMP 


DEVPIC 




DAC 


DEVAC 




LAC 


DEVINT 




DAC 


DEVOUT 




lORS 






SMAICLA 






LAW 


17740 




TAD 


DEVION 


DVSTON 


DAC 
DEVCF 


DVSWCH 


DEVION 


ION 





/SAVE AC. 

/SAVE PC, LINK, EX.MODE, MEM.PROT. 
/FORCE ION AT DISMISSAL. 

/PIC ENTRY. 

/API ENTRY, SAVE AC, 

/SAVE PC, LINK, EX.MODE, MEM.PROT. 

/CHECK STATUS OF PIC 

/FOR RESTORATION AT DISMISSAL. 

/PIC OFF, BUILD lOF lOT. 

/PIC ON, BUILD ION lOT. 

/CLEAR DEVICE DONE FLAG 
/ENABLE PIC SO THAT OTHER DEVICES 
/ARENT SHUT OUT. 



lOF 
DEVIOT 



/DISABLE PIC TO INSURE 
/DISMISSAL BEFORE INTERRUPT 
/FROM THIS lOT OCCURS 



/DISMISS ROUTINE 
LAC 
DAC 
LAC 

DVSWCH ION 

DBR 
JMP* 



(JMP DEVPIC /RESTORE DEVINT IN 

DEVINT /CASE API DISABLED. 

DEVAC /RESTORE AC 

/ION OR lOF 

/DEBREAK AND RESTORE CONDITIONS 
DEVOUT /OF LINK, EX.MODE AND MEM.PROT. 

Since the auto-index registers and EAE registers are not used by the standard I/O device handlers, it is not necessary 
to save and restore them. 



The Monitor routine (.SETUP) checks the skip chain for the instruction which matches SKP lOT; if there is a match it 
places the address, DEVINT, in the appropriate transfer vector (INTn) and places JMS* INTn in the corresponding 
API channel register. If a match cannot be found, lOPS outputs the following error message, 

.lOPS 05 XXXXXX 
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indicating that the skip lOT in the CAL calling sequence at location XXXXXX was not in the skip chain. 

Refer to paragraph 4.2.4 for the method of incorporating new handlers and associated skip chain entries into the 
Monitor. 



4.1.2 API Software Level Handlers 



4.1.2.1 Setting Up API Software Level Channel Registers - When the Monitor is loaded, the API software-level 
channel registers (40 through 43) are initialized to 

JMS* .SCOM+12 /LEVEL 4 

JMS* .SCOM+13 /LEVELS 

JMS * .SCOM+ 1 4 /LEVEL 6 

JMS* .SCOM+15 /LEVEL 7 

where the .SCOM registers are at absolute locations 001 12 through 001 15 and contain the address of an error routine. 

Therefore, prior to requesting any interrupts at these software priority levels, the user must modify the contents of 
the .SCOM registers so that they point to the entry point of the user's software level handlers. 

Example: 

.SCOM = 100 

LAC (LV5INT 

DAC* (.SCOM+13 



LV5INT exists in the user's area in the following format: 



LV5INT /PC, LINK AND MEM. PROT. 

DAC SAV5AC /SAVE AC 

/SAVE AUTO INDEX REGISTERS 
/IF LEVEL 5 ROUTINES 
/USE THEM AND LOWER LEVEL 
/ROUTINES ALSO USE THEM 
/SAVE MQ AND STEP COUNTER 
/IF SYSTEM HAS EAE AND IT 
/IS USED AT DIFFERENT LEVELS. 



/RESTORE SAVED REGISTERS. 

DBR /DEBREAK FROM LEVEL 5 

XCT .+1 

JMP* LV5INT /AND RESTORE LINK AND MEM.PROT. 
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4.1.2.2 Queueing - High priority/high data rate/short access routines cannot perform complex calculations based on 
unusual conditions without holding off further data inputs. To perform the calculations, the high priority program 
segment must initiate a lower priority (interrup table) segment to perform the calculations. Since, in general, many 
data handling routines will be requesting calculations, there will exist a queue of calculation jobs waiting to be 
performed at the software level. Each data handhng routine must add its job request to the appropriate queue (taking 
care to raise the API priority level as high as the highest level that manipulates the queue before adding the request) 
and issue an interrupt request (ISA) at the corresponding software priority level. The general flow chart, Figure 4-1 
depicts the structure of a software level handler involved with queued requests. 



LV5INT 



SAVE PC, LINK, AC. 

AUTO-INDEX REGS, 

MQ, STEP COUNTER 

AND CONDITIONS 

OF EXTEND MODE 

AND MEMORY PROTECT 




RAISE TO HIGHEST 

LEVEL THAT 

MANIPULATES 

LEVELS QUEUE 



REMOVE ENTRY 

FROM QUEUE 



DBK BACK 
TO LEVEL 5 



GO HONOR THIS 

JOB REQUEST VIA 

A JMS 



YES 



RESTORE SAVED 
REGISTERS 




Figure 4-1. Structure of API Software Level Handler 



Care must be taken about which routines are called when a software level request is honored; that is, if a called 
routine is "open" (started but not completed) at a lower level, it must be reentrant or errors will result. 



NOTE 



The standard hardware I/O device handlers do not contain reentrant 
procedures and must not be reentered from higher software levels. 

New resident handlers for Power Fail, Memory Parity, nonexistent memory 
violation, and Memory Protect violation have been incorporated into the 
system and effect an lOPS error message if the condition is detected (see 
Appendix E for lOPS errors). The user can, via a .SETUP, tie his own 
handler to these skip lOT or API channel registers. 
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4.1.3 Standard API Channel/Priority Assignments 



Channel 



1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 
20 
21 

22 
23 
24 

25 



Device 


Option 




Number 


Software Priority 


- 


Software Priority 


- 


Software Priority 


- 


Software Priority 


— 


DECtape 


TC02 


MAGtape 


TC59 


RESERVED 


— 


RESERVED 


— 


Paper Tape Reader 


- 


Clock overflow 


- 


Power Fail 


KF15 


Parity 


MP15B 


Display (LP flag) 


VP15 


Card Reader 


CR03B 


Line Printer 


LP15A/LP15C 


A/D 


AFOl/ADCl/9 


DB99/DB98 


DB09 


RESERVED 


- 


Data Phone 


DP09A 


DECdisk 


RF15 


DISK Pack 


RP15 


Plotter 


565 



Priority 

4 

5 

6 

7 
1 



Channel 
Register 



40 
41 

42 
43 
44 
45 
46 
47 
50 
51 
52 
53 
54 
55 

56 
57 
60 
61 
62 
63 
64 
65 
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Channel 



34 



35 



Device 


Option 




Number 


Multi-Station 


LT19A (Tele- 


TTY Control 


printer) 


Multi-Station 


LT19A (Key- 


TTY Control 


board) 



Priority 



Channel 
Register 

74 
75 



NOTE: Channels 26-33, 36 and 37 and corresponding Channel Registers are reserved. 



4.2 WRITING SPECIAL I/O DEVICE HANDLERS 

This section contains information prepared specifically to aid those users who plan to write their own special I/O 
device handlers for the Basic I/O Monitor system. 

Although special handlers cannot be incorporated directly into the Basic Monitor System, they can be designed to run 
with user programs in the Basic Monitor environment (see paragraph 4.2.4). If a user wishes to incorporate a special 
handler into a systems program (for example, a card punch handler for MACRO 15), he must purchase the source 
tape and assemly listings, modify them symbolically, and reassemble using at least a 16K machine. 

It is assumed that the user is familiar with paragraph 4.1. To summarize, the handler is entered via a JMP from the 
Monitor as a result of a CAL instruction. The contents of the AC contain the address of the CAL in bits 3 through 17. 
Bit contains the Link, bit 1 contains the extend mode status, and bit 2 contains the memory protect status. The 
previous contents of the AC and Link are lost. 

To show the steps required in writing an I/O device handler, a complete handler (Example B) was developed with the 
aid of a skeleton handler (Example A). This handler is a non-reentrant type (discussed briefly at the beginning of this 
chapter) and uses the Debreak and Restore instruction (DBR) to leave the handler at software priority level 4 (if API), 
and restore the status of the Link, extend mode, and memory protect. Example A is referenced by part numbers to 
illustrate the development of Example B, a finished Analog to Digital Converter (ADC) I/O Handler. The ADC 
handler shown in Example B, was written for a hypothetical basic analog-to-digital converter with lOT instructions as 
shown in Table 4-1. This handler is used to read data from the ADC and store it in the user's line buffer. The handler 
shown in Example B is for instructional purposes only; it has not been thoroughly tested. 

TABLE 4-1. Hypothetical A/D Converter lOT Instructions 



Mnemonic 


Octal 


Operation 


Symbol 


Code 


Executed 


ADSF 


701301 


Skip if converter flag is set. This flag is connected to the program 
interrupt. 


ADSC 


701304 


Select and convert. The converter flag is cleared and a conversion of an 
incoming voltage is initiated. When the conversion is complete, the 
converter flag is set. 


ADRB 


701312 


Read converter buffer. Places the content of the buffer in the AC, left 
adjusted. The remaining AC bits are cleared. The converter flag is 
cleared. 
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The reader, while looking at the skeleton of a specialized handler as shown in Example A, should make the following 
decisions about his own handler (The decisions made in this case are in reference to developing the ADC handler): 

a. Services that are required of the handler (flags, receiving or sending of data, etc.). By looking at the ADC lOT's 
shown in Table 4-2, it can be seen that there are three lOT instructions to be implemented. These instructions are: 
Skip if Converter Flag Set; Select and Convert; and Read Converter Buffer. 

The only service the ADC handler performs is that of receiving data and storing it in user specified areas. This handler 
will have a standard 256-word buffer. 

b.Data Modes used (for example, TOPS ASCII, etc.). Assuming that there is only one data mode for this device, 
mode specification is unnecessary in Example B. 

c. Which I/O macros are needed for the handler's specific use, that is, .INIT, .CLOSE, .READ, etc. These are fully 
described in Chapter 2 of this manual. For an ADC, the user would be concerned with three of the macros. 

.INIT would be used to set up the associated API channel register and the interrupt skip lOT sequence in the 
Program Interrupt (PIC) skip chain. This is done by a CAL (N) as shown in Part III of Example A, where (N) is 
the channel address. The standard device/ API channel associations can be found in paragraph 4.1.3. 

.READ is used to transfer data from the ADC. When the .READ macro is issued, the ADC handler will initiate 
reading of the specified number of data words and then return control to the user. The analog input data 
received is in its raw form; it is up to the programmer to convert the data to a usable format. 

.WAIT detects the availability of the user's buffer area and ensures that the I/O transfer is completed. It would 
be used to ensure a complete transfer before processing the requested data. 

d. Implementation of the API or PIC interrupt service routine. Example A shows an API or PIC interrupt service 
routine that handles interrupts, processes the data and initiates new data requests to fully satisfy the .READ macro 
request. Note that the routines in Example A will operate with or without API. Example B used the routines exactly 
as they are shown in Example A. 

During the actual writing of Example B, consideration was given to the implementation of the I/O Macros in the new 
handler in one of the following ways; 

(1) Execute the function in a manner appropriate to the given device as discussed in (c). .INIT, .READ, 
.WAIT were implemented into the ADC handler (Example B) under the subroutine names ADINIT, 
ADREAD, ADWAIT. 

Wait for completion of previous I/O. (Example B shows the setting of the ADUND switch in the 
ADREAD subroutine to indicate I/O underway.) 

(2) Ignore the function if meaningless to the device. See Example B (.FSTAT results in JMP ADIGN2) in 
the dispatch table DSPCH. For ignored macros, the return address must be incremented depending 
upon the argument string after the CAL. The number of arguments for each macro is shown in Chapter 

2. 

(3) Issue an error message in the case where it is not possible to perform the I/O function. (An example 
would be trying to execute an .ENTER on the paper tape reader.) In Example B the handler jumps to 
DVERR6 which returns to the Monitor with a standard error code in the AC. 
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After the handler has been written and assembled, the user must assemble the handler and splice it to the I/O Libraiy 
Tape. This procedure is described in 4.2.4. 



4.2.1 Discussion of Example A by Parts 



Part 1 



Stores CAL pointer and argument pointer; also picks up function code 
from argument string. 



Part 2 



By getting proper function code in Part 1 and adding a JMP DSPCH, 
the CAL function is dispatched to proper routine. 



Parts 



This is the .SETUP CAL used to set up the API channel register and PIC 
skip chains. Section 4.1.3 of this manual shows the standard device/ API 
associations. 



Part 4 
Parts 



Shows the API and PIC handlers. It is suggested these be used as shown. 

This area reserved for processing interrupt and performing any 
additional I/O. 



Part 6 

Part 7 



Interrupt dismiss routine. 

Increments argument pointer in bypassing arguments of ignored macro 
CAL's. 



4.2.2 Example A, Skeleton I/O Device Handler 



r 



/SPECIALIZED 1/ 
/CAL ENTRY ROUT 

,GLOBL 
,«ED=3 
DEV. DAC 

DAC 

ISZ 

LAC* 

AND 

ISZ 

TAD 

DAC 

XX 

JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 



'^SPCH 



HANDLER 

INE 

DEV. 

DVCALP 

DVARGP 

DVARGP 

DVARGP 

(77777 

DVARGP 

(JMP DSPCH) 

DSPCH 

DVINIT 
DVFSAT 
DVSEEK 
DVENTR 
DVCLER 
DVCLOS 
DVMTAP 
DVREAD 
DVWRTE 
DVWAIT 
DVTRAN 



/MUST BE OF FORM AAA. 

/.MED (MONITOR ERROR DIAGNOSTIC) 

/SAVE CAL POINTER 

/AND ARGUMENT POINTER 

/POINTS TO FUNCTION CODE 

/GET CODE 

/REMOVE UNIT # IF APPLICABLE 

/POINTS TO CAL + 2 



/DISPATCH 
/MODIFIED 



WITH 
JUMP 



/I ' 
/2 = 
/5 = 
/4 = 
/5 = 
/6 r 
/7 : 
/10 r 
/il ' 
/12 = 
/i5 - 



.INIT 
.FSTAT, 
.SEEK 
.ENTER 
.CLEAR 
.CLOSE 
.MTAPE 
.READ 
.WRITE 
.WAIT 
.TRAN 



.DELET, .RENAM 
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/ILLEGAL FUMCTIONS IN ABOVE TABLE CODED AS: 
/ JMP DVERRG 



o 






/FUNCTION CODE ERROR 
DVERR6 LAW S 

JMP* (.MED+1) 

/DATA MODE ERROR 
DVERR7 LAW 7 

JMP* (,MED+l) 

/DEVICE NOT READY 
DVERR4 LAC (RETURN) 



DAC* (.MED) 

LAC (A) 

JMP* (.MED+1) 



/I/O UNDERWAY LOOP 
DVBUSY DBR 
JMP* 



/ERROR CODE 6 
/TO MONITOR 



/ERROR CODE 7 
/TO MONITOR 



/RETURN (ADDRESS IN HANDLER 
/TO RETURN TO WHEN NOT READY 
/CONDITION HAS BEEN REMOVED) 

/ERROR CODE 4 
/TO MONITOR 



DVCALP 



/NORMAL RETURN FROM CAL 
DVCK DBR 

JMP* DVAR^P 



/BRiiAK FROM LEVEL A 
/LOOP ON CAL 



/BREAK FROM LEVEL 4 
/RETURN AFTER CAL AND 
/ARGUMENT STRING. 



/THE DVINIT ROUTINE MUST INCLUDE 

/A. SETUP FOR 

/EACH FLAG CONNECTED TO PIC (AT BUILD TIME) 

/ONE OF THESE MAY ALSO BE THE API SETUP CALL. 

/THE SETUP CALLING SEQUENCE IS: 



DVINIT CAL 



N 



16 

SKP lOT 
DBVINT 



/N = API CHANNEL REGISTER 
/(40-77); IF NOT 
/CONNECTED TO API 

/lOPS FUNCTION CODE 
/SKIP lOT TO TEST THE FLAG 
/ADDRESS OF INTERRUPT 
/HANDLER (API OR PIC) 



/THIS SPACE CAN BE USED FOR I/O SUBROUTINES 





/INTERRUPT HANDLER FOR 




DEVPIC 


DAC 


DEVAC 






LAC* 


(0) 






DAC 


DEVOUT 


^ 




LAC 


DEVION 


^ ^ 




JMP 


DVSTON 


£ ^ 


DEVI NT 


JMP 


DEVPIC 






DAC 


DEVAC 






LAC 


DEVI^T 






DAC 


DEVOUT 






lORS 





API OR PIC 

/SAVE AC 

/SACE PC, LINK, 

/MEM. PROT. 

/FORCE ION AT DISMISSAL 

/PIC ENTRY 

/API ENTRY, SAVE AC 

/SAVE PC, LINK, 

/MEM. PROT. 

/CHECK STATUS OF PIC 
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SMA!CLA 






/FOR RESTORATION 


LAW 


17740 




/DISMISSAL 


TAD 


DEVION 






DAC 


DVSWCH 






DEVCF 






/CLEAR FLAG 


ION 






/ENABLE PIC 


THE AREA DEVOTED 


TO 


PROCESSING INTERRUPT 



AT 



DVSTON 
.DEVION 



/THIS IS 

/PERFORMING ANY ADDITIONAL I/O DESIRED. 



AND 



lOF 
DEVIOT 



/DISABLE PIC TO INSURE 
/DISMISSAL 'BEFORE 
/INTERRUPT FROM THIS 
/lOT OCCURS 



/INTERRUPT HANDLER DISMISS RTE 



M3 



DVDISM 



DVSWCH 



LAC 
DAC 
LAC 
ION 
DBR 
JMP* 



(JMP DEVPIC) 
DEVI NT 
DEVAC 



DEVOUT 



/RESTORE PIC ENTRY 

/RESTORE AC 
/ION OR lOF 
/DE8REAK AND RESTORE 
/LINK, MEM. PROT. 



/IF THE HANDLER USES THE AUTO-INDEX 

/OR 

/EAE REGISTERS, THEIR CONTENTS 

/SHOULD BE 

/SAVED AND RESTORED. 

/FUNCTIONS POSSIBLY IGNORED SHOULD 

/CONTAIN PROPER INDEXING TO BYPASS 

/ARGUMENT STRING. 



^ /DVIGN2 



ISZ 

JMP 



DVARGP 
DVCK 



/BYPASS FILE POINTER 



4.2.3 Example B, Special I/O Handler for Hypothetical A/D Converter 



/ADC lOT'S 
ADSF=701301 
ADSC=701304 
ADRBr70l3l2 

/ADSFrSKIP IF CONVERTER FLAG IS SET 
/ADSCrSELECT AND CONVERTCADC FLAG IS LEARED 
/AND A CONVERSION IS INITIALITED) 
/ADRBrREAD CONVERTER BUFFERCPUTS CONTENTS IN AC) 
/CAL ENTRY ROUTINE 
.GLOBL ADC. 



.MED=5 
ADC. 



DAC ADCALP 
DAC ADARGP 
ISZ ADARGP 
LAC* ADARGP 
ISZ ADARGP 
TAD (JMP DSPCH) 
DAC DSPCH 



/ADC. IS GLOBAL NAME FOR HANDLER 

/MEDCMONITOR ERROR DIAGNOSTIC) 

/SAVE CAL POINTER 

/AND ARGUMENT POINTER 

/POINTS TO FUNCTION CODE 

/GET CODE 

/POINTS TO CAL + 2 

/DISPATCH WITH 
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DSPCH XX 




/MODIFIED JUM 


JMP 


ADINIT 


/I = .INIT 


JMP 


ADnN2 


/2 = .FSTAT, 


JMP 


ADIGN2 


/5 = .SEEK 


JdP 


ADFRR^ 


/4 : .ENTER 


JMP 


ADFRR5 


/5 = .CLEAR 


JMP 


ADOK 


/6 :: .CLOSE 


JMP 


ADOK 


/7 r .MTAPE 


JMP 


ADREAD 


/10 z .READ 


JMP 


ADERRS 


/ll r .WRITE 


JMP 


ADWAIT 


/12 = .WAIT 


JMP 


ADERR6; 


/13 z .TRAN 


/ILLEGAL FUNCTIONS IN 


ABOVE TABLE CODED AS: 


/ JMP 


ADERRS 




/FUNCTION CODE ERROR 




ADERRS LAW 


e 


/ER.^OR CODE 6 


JMP^ 


= (.MED+1) 


/TO MONITOR 


/DATA MODE ERROR 




ADERR7 LAW 


7 


/ERROR CODE 7 


JMPf 


^ (.MED+1) 


/TO MONITOR 



.DELET, .RENAM 



/THE ADINT ROUTINE MUST INCLUDE A 

/ SETUP FOR 

/EACH FLAG ASSOCIATED WITH THE 

/DEVICE 

/THE .SETUP CALLING SEQUENCE IS: 

/IDY TO RET STNDRD BUFF SIZE 

/STANDARD BUFFER SIZE (DECIMAL) 

/PUT BACK STANDARD BUFFER SIZE 

/57=>PI CHANNEL REGISTER 

/(40-77): IF NOT 

/CONNECTED TO API 

/.SETUP lOPS FUNCTION CODE 

/ADC SKIP JOT TEST THE FLAG 

/ADDRESS OF INTERRUPT 

/HANDLER (API OR PIC) 

/ERASES CALL FUNCTION IN CASE 

/OF FURTHER .INIT'S THEY WILL BE 

/IGNORED BY THIS JMP TO ADSTOP 

/WHERE THE I/O UNDERWAY SWITCH 

/IS CLEARED AND ^LL I/O IS 

/TERMINATED 

/THE PREVIOUS SIX TAGS IN THE CAL AREA ARE USED FOR TEMP 

/STORAGE DURING THE ACTUAL .READ FUNCTION 

/ADCKSM IS FOR STORING THE CHECKSUM 

/ADDRP IS THE CURRENT BUFFER POINTER 

/ADLRHP IS THE LINE BUFFER HEADER POINTER 

/ADUND IS FOR DEVICE UNDERWAY SWITCH 

/ADRWC IS USED AS A -WORD COUNT REGISTER 

/ADRWCT IS USED TO STORE CURRENT WORD PAIR COUNT 

/STOP ADC ROUTINE CLEARS I/O UNDER WAY SWITCH 

ADSTOP DZM ADUND 

/ADC WAIT LAC ADUND 
SNA 
JMP ADOK 



ADINIT 


ISZ ADARGP 




.DEC 




LAC (2*^(5 




.OCT 




DAC* ADARGP 




ISZ ADARGP 




CAL 57 


ADCKSM 


16 


ADCBP 


ADSF 


ADLBHP 


ADCINT 


ADUND 


LAC .+2 


ADWRC 


DAC .-5 


ADWPCT 


JMP ADSTOP 
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/I/O UMDERWAY LOOP 
ADBUSY DBR 

J>1P* ADCALP 



ADREAD 


LAC ADUND 




SZAICMA 




JMP ADBUSY 




DAC ADUND 




LAC* ADARGP 




DAC ADDBP 




DAC ADLBHP 




ISZ ADARGP 




LAC* ADRAGP 




DAC ADRWC 




ISZ ADARGP 




DZM ADWPCT 




DZM ADCKSM 




ISZ ADDBP 




ISZ ADDBP 




ADSC 


/NORMAL RETURM FROM CAL 


ADOK 


DBR 




JMP* ADARGP 


/INTERRUPT HANDLER FOR API 


ADCPIC 


DAC ADCAC 




LAC* (0) 




DAC ADCOUT 




LAC ADCION 




JMP ADSTON 


ADCINT 


JMP ADCPIC 




DAC ADCAC 




LAC ADCINT 




DAC ADCOUT 




LAC CJMP ADCPIC) 




DAC ADCINT 




lORS 




SMA!CLA 




LAW 17740 




TAD ADCION 


ADSTON 


DAC ADSWCH 




ADRB 


ADCION 


ION 




DAC* ADDBP 




ISZ ADDBP 




ISZ ADWPCT 




TAD ADCKSM 




DAC ADCKSM 




ISZ ADRWC 




JMP ADCONT 




LAC ADWPCT 




TAD (1 




RTL 




RTL 




RTL 




RTL 



/CHECK TO SEE IF 

/IF NOT SET IT WI 

/IT WAS SET, GO B 

/SET IT 

/GET LINE SUFFER 

/STORE IT 

/ALSO STORE IT FO 

/INCREMENT ARG. P 

/GET -L,B.W.C.(2' 

/STORE IT IN WORD 

/INCREMENT FOR Ex 

/ZERO WORD PAIR C 

/ZERO CHECKSUM HE 

/GET PAST HEADER 

/NOW POINTING AT 

/BUFFER 

/START UP DEVICE 



I/O IS UNDERWAv 

TH -I 

ACK TO CAL 

HEADER POINTER 

R LATER HEADER 

OINTER 

S COMP) 

COUNT REGISTER 
IT FROM .READ 
OUNT REG. 
G. 

PAIR 
BEGINNING OF 



/BREAK FROM LEVEL 4 
/RETURN AFTER CAL 



OR PIC 

/SAVE AC 

/SAVE PC, LINK, 

/MEM. PROT. 

/FORCE ION AT DISMISSAL 

/PIC ENTRY^ 

/API ENTRY, SAVE AC 

/SAVE PC, LINK, 

/MEM. PROT. 

/RESTORE PIC ENTRY BECAUSE PIC 

/A JMS CALL NOT A JUMP 

/CHECK STATUS OF PIC 

/FOR RESTORATION AT 

/DISMISSAL 



/READ CONVERTER BUFFER 

/ENABLE PIC FOR OTHER DEVICES 

/STORE DATA IN USER BUFFER 

/INC. BUFFER POINTER 

/INC. WORD PAIR COUNTER 

/ADD CHECKSUM 

/STORE IT 

/IS I/O COMPLETE 

/NO KEEP GOING 

/YES, COMPUTE WORD COUNT PAIR 

/ADD ONE MAY BE ODD 

/DIVIDE BY TWO, AT SAME TIME 

/ADJUST IT, FOR HEADER 
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AND (377000 




DAC* ADLBHP 




ISZ ADLBHP 




TAD ADCKSM 




DAC* ADLBHP 




DZM ADUND 




JMP ADDISM 


ADCONT 


I OF 




ADSC 


/INTERRUPT HANDLER DISMISS RTE 


ADDISM 


LAC ADCAC 


ADSWCH 


ION 




DBR 




JMP* ADCOUT 


ADCAIP 





ADARGP 





ADCOUT 





ADCAC 






/ALL SET 

/STORE IN HEADER #1 

/INC. TO STORE CKSUM 

/ADD WORD PAIR COUNT 

/STORE IN HEADER #2 

/CLEAR DEVICE UNDERWAY 

/EXIT 

/DISABLE PIC TO INSURE 

/DISMISSAL PEFORE 

/INTERRUPT FROM THIS 
/lOT OCCURS 

/RESTORE AC 

/ION OR lOF 

/DEBREAK AND RESTORE 

/LINK, MEM. PROT. 

/ADC CAL POINTER 

/ADC ARGUEMENT POINTER 

/PC,L,MP 

/AC SAVED HERE 



/IF THE HANDLER USES THE AUTO- INDEX 

/OR 

/EAE REGISTERS, THEIR CONTENTS 

/SHOULD BE 

/SAVED AND RESTORED. 



/FUNCTIONS POSSIBLY IGNORED 
/CONTAIN PROPER INDEXING TO 
/ARGUMENT STRING. 



SHOULD 
BYPASS 



ADIGN2 



ISZ ADAR 
JMP ADOK 
.END 



/BYPASS FILE POINTER 
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4.2.4 Incorporating User-Generated I/O Handlers 

4.2 A. I The following example shows how to incorporate a user generated I/O handler for a special or non-standard 
device (e.g., Type 350 incremental plotter) into the standard I/O Library. This means that the Linking Loader, DDT, 
or DDTNP must be modified to recognize the new handler. The changes to be made include .DAT Slot modification 
and skip chain modification. If the user wishes to use his own handler name, instead of one of the standard handler 
names (e.g., PLA., instead of LPA.), a radix 50 value in the Loader I/O Configuration (IOC) Table must be changed. 

4.2.4.2 Procedure: 

a. Load the Linking Loader as follows: 

(1) Set the ADDRESS Switches to 17720 of the highest core bank. 

(2) Place the Linking Loader tape in the reader. 

(3) Press RESET then READIN. 

b. Stop the computer at the point where the Loader types tS and modify the appropriate .DAT Slot (Slot begins 
at location 135) according to the Loader IOC Table (Table 4-2). Suppose .DAT Slot 4 is chosen and the user wishes to 
substitute his plotter handler for handler LPA.. Cell 141 (.DAT Slot 4) should be changed from 000001 (Loader code 
for TTA.) to 000007 (Loader code for LPA.). 

c. Modify the Monitor Skip Chain (Table 4-3) as follows; 

(1) Determine the proper Skip lOT instruction code (octal) assigned to the device, either from the User's 
Guide DEC-15-H2DA-D (in the case of standard DEC I/O devices) or from engineering documentation 
supplied to the customer (for customer specified devices). 

(2) Load the new lOT in the desired Skip Chain location. In case of the plotter mentioned above, the Skip 
lOT (from the User's Guide) is 702401 (PLSF). The skip associated with LPA. is at location 1533 as 
shown in Table 4-3, Location 1533 should be changed from 706501 (LSDF) to 702401 (PLSF). 

If the user has named his plotter handler LPA., he may proceed to step E below. 

d. If the user prefers a different name* (e.g., PLA.), the radix 50 value associated with the LPA handler in the 
IOC Table (Table 4-2) must be changed. Compute the new radix 50 value as follows: 

(1) Find P in column 1 of Table 4-4 (062000). 

(2) Find L in column 2 (000740). 

(3) Find A in column 3 (000001). 

(4) The resultant radix 50 value is 062741. 

(5) The fourth character of the mnemonic PLA. is the period (.). 

This is signified to the Loader by making the sign bit of the computer word (bit 0) a 1 . The resulting 
radix 50 value is now 462741. 



*The new name must consist of from one to three alphabetic characters followed by a period. 
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(6) Hence the contents of location 4505 (Loader) or 5264 (DDT) should be changed to 462741. 

e. Load PUNCH-1 5 as follows: 

(1) Set the ADDRESS Switches to 1 7720 of the highest core bank. 

(2) Place the PUNCH- 15 tape in the reader. 

(3) Press RESET then READIN, 

f. When the PUNCH-1 5 query ''tP, T OR S?" appears on the teletype, type CTRL P. 

g. When PUNCH-1 5 replies with a >, type the number of output tapes desired (in this case 1 - up to 9 if 
desired.) 

h. To load the resultant tape(s), proceed as in Step a. The computer stops after loading each tape except the 
last. Press CONTINUE when the next tape is in the reader. Program execution begins automatically when the end of 
the last tape is reached. 

i. Assemble the new handler in relocatable binary form. Remove the end-of-file (EOF) block using PIP-15 with 
the 'W switch option. Attach this tape to the end of the first tape in the I/O Library. 

Table 4-2. Linking Loader IOC Table 



Handler 


Code 


Location 


Radix 

50 
Value 


Slot 


Loader/DDTNP 


DDT 


TTA. 


1 


4477 


5256 


500041 


PRA, 


2 


4500 


5257 


463321 


PRB. 


3 


4501 


5260 


463322 


PPA. 


4 


4502 


5261 


463201 


PPB. 


5 


4503 


5262 


463202 


PPC. 


6 


4504 


5263 


463203 


LPA. 


7 


4505 


5264 


446601 


CDA. 


10 


4506 


5265 


411541 


CDB. 


11 


4507 


5266 


411542 


CDC. 


12 


4510 


5267 


411543 


MTF. 


13 


4511 


5270 


452146 


DRA. 


14 


4512 


5271 


415721 


DRB. 


15 


4513 


5272 


415722 


DRC. 


16 


4514 


5273 


415723 


DRD. 


17 


4515 


5274 


415724 



tThe IOC Table Locations shown above are subject to change in later versions of DDT and the Linking Loader. For information regarding 

these chanpftS <iep th** Rparlpr <;prvi^^^ r-^r,^ a+ +Ua. c.^A ^f +t,;^ ™ i "i.^^ii i^^gaiumg 



these changes, see the Reader Service Card at the end of this manual. 
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Locationt 



Table 4-3. Basic I/O Monitor Skip Chain' 
Contents Mnemonic 



Device Meaning 



1521 

1522 

1523 

1524 

1525 

1526 

1527 

1530 

1531 

1532 

1533 

1534 

1535 

1536 

1537 

1540 

1541 

1542 

1543 

1544 

1545 

1546 

1547 

1550 

1551 

1552 

1553 

1554 

1555 

1556 

1557 

1560 

1561 

1562 

1563 

1564 

1565 

1566 

1567 



703201 

741000 

6215T1 

707341 

741006 

621604 

700001 

741000 

600476 

706701 

741000 

621575 

706721 

741000 

621576 

706501 

741000 

621572 

700101 

741000 

621573 

700201 

741000 

621574 

700301 

741000 

601110 

700401 

741000 

601344 

701741 

741000 

621600 

701701 

741000 

621601 

702701 

741000 

621602 



SPFAL 

SKP 

JMP* INT6 

MTSF 

SKP 

JMP* INT 13 

CLSF 

SKP 

JMP CLKPIC 

RCSF 

SKP 

JMP* INT4 

RCSD 

SKP 

JMP* INT5 

LSDF 

SKP 

JMP* INT 1 

RSF 

SKP 

JMP* INT2 

PSF 

SKP 

JMP* INT3 

KSF 

SKP 

JMP TIINT 

TSF 

SKP 

JMP TOINT 

MPSNE 

SKP 

JMP* INT7 

MPSK 

SKP 

JMP* INT 10 

SPE 

SKP 

JMP* INT 11 



POWER FAIL 



MAGTAPE DONE 



CLOCK OVERFLOW 



CARD COLUMN READY 



CARD DONE 



LINE PRINTER DONE 



PAPER TAPE READER DONE 



PAPER TAPE PUNCH DONE 



KEYBOARD READY 



TELEPRINTER DONE 



NON-EXISTENT MEMORY 



MEMORY PROTECT VIOLATION 



MEMORY PARITY ERROR 



*This skip chain memory map applies only when the Linking Loader, DDT, DDTNP, CHAIN, EXECUTE or relocatable user pro- 
grams are in core. 

tThe skip chain locations shown above are subject to change in later versions of the associated software. For information regarding these 
changes, see the Reader Service Care at the end of this manual. 
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Table 4-4. Radix SOg Values 



X -- 


-X- 


-X 


A 


003100 


A 


000050 


A 


000001 


B 


006200 


B 


000120 


B 


000002 


C 


011300 


C 


000170 


C 


000003 


D 


014400 


D 


000240 


D 


000004 


E 


017500 


E 


000310 


E 


000005 


F 


022600 


F 


000360 


F 


000006 


G 


025700 


G 


000430 


G 


000007 


H 


031000 


H 


000500 


H 


000010 


I 


034100 


I 


000550 


I 


000011 


J 


037200 


J 


000620 


J 


000012 


K 


042300 


K 


000670 


K 


000013 


L 


045400 


L 


000740 


L 


000014 


M 


050500 


M 


001010 


M 


000015 


N 


053600 


N 


001060 


N 


000016 





056700 





001130 





000017 


P 


062000 


P 


001200 


P 


000020 


Q 


065100 


Q 


001250 


Q 


000021 


R 


070200 


R 


001320 


R 


000022 


S 


073300 


S 


001370 


S 


000023 


T 


076400 


T 


001440 


T 


000024 


U 


101500 


U 


001510 


U 


000025 


V 


104600 


V 


001560 


V 


000026 


W 


107700 


W 


001630 


w 


000027 


X 


113000 


X 


001700 


X 


000030 


Y 


116100 


Y 


001750 


Y 


000031 


Z 


121200 


Z 


002020 


z 


000032 


% 


124300 


% 


002070 


% 


000033 




127400 




002140 




000034 





132500 





002210 





000035 


1 


135600 


1 


002260 


1 


000036 


2 


140700 


2 


002330 


2 


000037 


3 


144000 


3 


002400 


3 


000040 


4 


147100 


4 


002450 


4 


000041 


5 


152200 


5 


002520 


5 


000042 


6 


155300 


6 


002570 


6 


000043 


7 


160400 


7 


002640 


7 


000044 


8 


163500 


8 


002710 


8 


000045 


9 


166600 


9 


002760 


9 


000046 


# 


171700 


# 


003030 


# 


000047 



4.3 I/O HANDLERS ACCEPTABLE TO SYSTEM PROGRAMS 

This section lists the .DAT slot requirements of system programs, the uses made of the .DAT slots, and the I/O 
handlers that may be assigned to each. It is imperative that one and only one 1/0 handler for a device be in core at the 
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same time; that is, PRA and PRB should not be brought in together since there is no communication between the two 
interrupt handlers. 



NOTE 



All system programs use .DAT slots -2 and -3 for teletype input and output, 
respectively. These assignments cannot be changed. 



4.3.1 FORTRAN IV 
.DAT Slot 

-11 



Use 

Input 



Handler 

TTA 

PRA 

PRB* 

MTF (non-file oriented) 

CDB 



12 



Listing 



TTA* 

LPA 

PPA 

MTF (non-file oriented) 



13 



Output 



PPA 
PPB* 

PPC 

MTF (non-file oriented) 



4.3.2 IVIACRO-15 

MACRO-15 is identical to FORTRAN IV, with two exceptions: a If .ABS binary output is requested on .DAT slot 
-13, PPC. cannot be used, b When the P option (in the command string) is used, .DAT slot -10 is the secondary input 
device: 

TTA* 
PRA 
PRB 
CDB 



4.3.3 FOCAL 

.DAT Slot 

+3 
*DEC Standard assignment. 



Use 

Input 



Handler 

PRA* 

PRB 

CDB 
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.DAT Slot 


Use 


Handler 


+5 


Output 


PPA* 
LPA 


4.3.4 Editor 






.DAT Slot 


Use 


Handle 


-10 


Secondary Input 


TTA 
PRA* 
PRB 
CDB 


-14 


Input 


TTA 

PRA* 

PRB 

CDB 


-15 


Output 


LPA 
TTA 
PPA* 



4.3.5 Linking Loader and DDT 
.DAT Slot 

-1 



Use 

System 
Library 



-4 


Input 


-5 


Externa 




User Li 


4.3.6 PIP 




.DAT Slot 


Use 


1 


I/O 


2 


I/O 


3 


Input 


4 


Output 


5 


Output 


6 


Input 


7 


Output 


10 


Input 



Handler 

PRA* 

PRA* 



NONE* 
PRA 



Handler 

TTA* 

TTA* 

PRA* 

LPA* 

PPA* 

CDB* 

PPA* 

PRA* 



*DEC Standard assignment 
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4.3.7 Chain Builder 




.DAT Slot 


Use 


-1 


System Library 


-4 


User Programs 


-5 


External 




Library 


-6 


Output 



4.3.8 Chain Execute 




.DAT Slot 


Use 


-4 


Chain Input 


4.3.9 STRAW 




.DAT Slot 


Use 


-14 


Output 


-15 


Input 



Handler 

PR A* 
PR A* 

NONE* 

PPA* 

PPB 

PPC 



Handler 
PRA* 

Handler 

PPA* 
PR A* 

CDB 



4.4 SUMMARY OF STANDARD I/O HANDLER FEATURES 



4.4.1 TT A -(Teletype) 

a. Functions - All function descriptions (except READ and WRITE) refer to action taken when either the 
teleprinter or the keyboard is addressed. 



Mnemonic 
.INIT 



Code 

1 



(1) 
(2) 



Action 

Return standard buffer size (34i ^ ). 

Assign return addresses for certain control characters from contents of 
CAL ADDRESS +2. Bits through 1 in CAL + 2 address are set to 
designate caller: 



BO, 1 =01 
BO, 1 = 10 
BO, 1 = 00 



caller - Monitor 

caller = DDT 

caller = any other user 



*DEC Standard Assignment 



(3) Set I/O UNDERWAY indicator. 

(4) Print carriage return and line feed (CR/LF), 
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Mnemonic 


Code 


Action 


.DLETE 


2 


Ignored 


.RENAM 


2 


Ignored 


.FSTAT 


2 


Ignored 


.SEEK 


3 


Ignored 


.ENTER 


4 


Ignored 


.CLEAR 


5 


Ignored 


.CLOSE 


6 


(1) Set I/O underway indicator. 

(2) Print CR/LF. 

(3) Wait on .CLOSE for completion of I/O. 


.MTAPE 


7 


Ignored 


.READ 


10 


(1) Set I/O underway indicator, 

(2) Set up to accept characters from keyboard, 


.WRITE 


11 


(1) Set I/O Underway indicator. 

(2) Printline. 


.WAIT 


12 


Allow input at output to finish. 


TRAN 


13 


IOPS06-Illegal function. 



b. Legal Data Modes 

lOPS ASCII (Mode 2) 

IMAGE ALPHANUMERIC (Mode 3) 



c. Vertical Carriage Control Characters 
Output - 



Input — 
d. Horizontal Carriage Control Characters 



(1) Line feed (128) 

lOPS ASCII: Ignore all leading line feeds; otherwise output 
IMAGE: Output 

(2) Others (vertical tab, form feed) output 
Inserted in buffer 



Tab (llg) in or out 
lOPS ASCII 

Image Alphanumeric 



(1) Model 33 - output sufficient number of spaces to place the next typed 
character in column 1 1 , . . ., 71. Insert only 1 Ig in buffer on input. 

(2) Model 35 - input, insert llg in buffer. Output, print tab. 
Input, insert 1 Ig in buffer. Output, print tab. 



e. Program Control Characters-IN 

Stop current I/O 
to Teletype. 

Decode character 
and echo on Tele- 
printer.* 



(1) CTRL C transfers control to the address specified as return in the 
TNIT performed by the Monitor. 



^Character will be ignored (not echoed) in cases (1), (2), and (3), if respective. .INIT has not been performed. 
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(2) CTRL P transfers control to the address specified as return in the .INIT 
performed by the user (other than the Monitor or DDT). 

(3) CTRL T transfers control to the address specified as return in the .INIT 
performed by DDT. 

(4) CTRL S transfers control to the address specified in .SCOM + 6. 



f. Data Control Characters-IN 
Image Alphanumeric 
lOPS ASCII 



All characters inserted in buffer as 7-bit characters. 

(1) Rubout. Delete previous character typed. Type out reverse slash (\). 

(2) CTRL U. Delete entire line typed so far. Type out commercial at (@). If 
output is UNDERWAY, printing is terminated and a CR/LF is output. 



g. Data Control Characters-OUT (both modes) 



Ignore RUBOUT (ITTg) and NULL (00). 

In Image Alpha mode, a RUBOUT should be used to fill the last word pair when an odd number of characters is 
to be output. 

h. Errors (no program-initiated recovery) 

IOPS6 - Illegal Function 
I0PS7 - Illegal Data Mode 



i. Program Sfze 



469 1 Q registers (this is included in resident MONITOR). 



j. Teletype I/O - Can be requested only from mainstream in API systems, since the Teletype is not connected to 
the API. 



4,4.2 PP (Paper Tape Punch) 

a. Functions 



Mnemonic Code 

.INIT 1 



Action 

( 1 ) Return standard buffer size (52i o )• 

(2) .SETUP -no API. 

(3) Punch two fanfolds of leader. 
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IVtnenx}nic 


Code 




Action 


.DLETE 


2 


Ignored 


.RENAM 


2 




Ignored 


.FSTAT 


2 


Ignored 


.SEEK 


3 




I0PS6 - Illegal function 


.ENTER 


4 




Ignored 


.CLEAR 


5 




Ignored 


.CLOSE 


6 


(1) 


Allow previous output to terminate. 






(2) 


Punch EOF if lOPS Binary 






(3) 


Punch two fanfolds of trailer 






(4) 


Allow trailer punching to terminate 


.MTAPE 


7 




Ignored 


.READ 


10 




I0PS6 - Illegal function 


.WRITE 


11 


(1) 


Allow previous output to terminate. 






(2) 


Output buffer 


.WAIT 


12 




Allow previous output to terminate. 


.TRAN 


13 




I0PS6 - Illegal function 


b. Legal Data Modes 








lOPS Binary 




(mode 0) 


IMAGE Binary 




(mode 1) 


lOPS ASCII 




(mode 2) 


IMAGE ALPHANUMERIC 


(mode 


^3) 


Dump 




(mode 4) 



c. Vertical Control Characters (lOPS ASCII only) 

May appear only as first character of line, if elsewhere in line will be ignored; if no vertical control character at 
beginning of line, a line feed (012) will be used. 
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012 
013 

014 



Line feed 

Vertical tab, followed by four deletes (177) 

Form feed, followed by 408 nulls (000) 



d. Horizontal Control Characters (lOPS ASCII only) 

01 1 Horizontal tab, followed by one delete ( 1 77) 

e. Recoverable Errors 

No tape in punch — Monitor error I0PS4 

( 1 ) Put tape in punch 



(2) Type CTRL R 



f. Unrecoverable Errors 
IOPS6 - Illegal Function: 





(1) 


.SEEK 




(2) 


.READ 




(3) 


.TRAN 


IOPS7 - lUegal Data Mode 






g. Program Size 






PPA. (all data modes) 




397 decimal registers 


PPB. (all except lOPS ASCII) 




270 decimal registers 


PPC. (lOPS binary only) 




210 decimal registers 
NOTE 



In API systems, the paper tape punch can be called only from mainstream, 
since the punch is not connected to the API. 



4.4.3 PR (Paper Tape Reader) 
a. Functions 
Mnemonic Code 

.INIT 1 



Action 

(1) Return standard line buffer size (52^ o) 

(2) .SETUP API channel register SOg 
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Mnemonic 

.DLETE 

.REN AM 

.FSTAT 

.SEEK 

.ENTER 

.CLEAR 

.CLOSE 

.MTAPE 
.READ 

.WRITE 
.WAIT 

.TRAN 



Code 

2 
2 
2 
3 
4 
5 
6 



11 
12 

13 



Action 

(3) Clear I/O UNDERWAY indicator 
Ignored 

Ignored 

Ignored 

Ignored 

IOPS6 - Illegal function 

I0PS6 - Illegal function 

Allow previous input to finish and then clear I/O UNDERWAY 
indicator. 

Ignored 

(1) Allow previous input to be completed. 

(2) Input line or block of data (see modes below). 

I0PS6 - Illegal function 

Allow previous input to be completed before allowing user program to 
continue. 

I0PS6 - Illegal function 



b. Legal Data Modes 

lOPS ASCII 

(mode 2) 



( 1 ) Constructs line buffer header, computing: 

Word pair count 
Data mode 
Data validity bits 

(2) Packs characters into the line buffer in 5/7 ASCII, checking parity 
(eighth bit, even) on each character. 

(3) Allows vertical form control characters. (FF, LF, VT) only in character 
position 1 of the Une buffer. Otherwise, ignored. 

(4) Terminates reading on CR or line buffer overflow. In the latter case, 
tape is moved past the next CR to be encountered. 
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lOPS Binary 
(Mode 0) 



(1) Reads binary data in alphanumeric mode, checking parity (seventh 
hold, odd) on each frame, 

(2) Accepts line buffer header at head of input data, modifying data 
validity bits if parity or checksum errors (or short Hne) have occurred. 

(3) Terminates reading on overflow of word pair count in line buffer 
header or word count in .READ macro, whichever is smaller, moving 
tape to end of line or block if necessary. 



Image 

Alphanumeric 
(Mode 3) 



( 1 ) Constructs line buffer header, computing: 

Word pair count 
Data mode 



(2) Stores characters, without editing, or parity cJiecking in the line buffer, 
one per register. 

(3) Terminates reading as a function of .READ macro word count. 



Image Binary 
(Mode 1) 

Dump 
(Mode 4) 



Same as Image Alphanumeric, except a binary read is issued to the 
PTR. 

Same as Image Alphanumeric except, no header is constructed; loading 
begins at the core address specified in the .READ macro. A binary read 
is issued to the PTR. 



NOTE 



An end of tape condition causes the PTR interrupt service routine to 
terminate the input line, turning off the I/O UNDERWAY program indicator 
and marking the header (data mode bits) as an EOM (end of medium) for all 
modes except Dump. 



c. Unrecoverable Errors 






Illegal Function 




(IOPS6) 




(1) 


.ENTER 




(2) 


.CLEAR 




(3) 


.WRITE 




(4) 


.TRAN 


Illegal Data Mode 




(I0PS7) 
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d. Program Size 

PRA. (all data modes) 
PRB. (lOPS ASCII only) 



436 decimal registers 
287 decimal registers 



4.4,4 CDB. (CARD READER CR03B) 



a. Functions 
Mnemonic 

.INIT 



NOTE 



When the CR03B is used as an EDITOR input, a blank card must be placed 
immediately after the End of File (EOF) card (card column 1 punched 
12-11-0-1-2-3-4-5-6-7-8-9). If an EOF card is not used to end a deck, the 
blank card is not required. 



Code Action 

1 ( 1 ) Return standard buffer size (36i o ) 

(2) Call .SETUP to update skipchain with PIC servicer addresses for column 
ready and card done flags and to place API servicer address in location 
558 (API channel 13). 



.DLETE 


2 


Ignored 


.RENAM 


2 




Ignored 


.FSTAT 


7 
z. 


Ignored 


.SEEK 


3 




Ignored 


.ENTER 


4 




I0PS6 - Illegal function 


.CLEAR 


5 




I0PS6 - Illegal function 


.CLOSE 


6 




Allow previously requested input to terminate 


.MTAPE 


7 




Ignored 


.READ 


10 


(1) 


Allow previously requested input to terminate. 






(2) 


Ensure that device is ready. 






(3) 


Initiate input of next card. 


.WRITE 


11 




IOPS6 - Illegal function 
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Mnemonic 


Code 


.WAIT 


12 


.TRAN 


13 


1. Legal Data Modes 





Action 

Allow previously requested input to terminate. 

IOPS6 - Illegal function 



lOPS ASCII (mode 2) Eighty card columns are read and interpreted as Hollerith (029 or 026) data, mapped into the 
corresponding 64-graphic subset of ASCII, and stored in the user's line buffers in 5/7 format (36i q locations required 
to store an 80 column card). Compression of internal blanks to tabs and truncation of trailing blanks is not 
performed; all 80 characters appearing on the card are delivered to the caller's line buffer. In addition, a carriage 
return (01 Sg) character is appended to the input line. A total of 81 ASCII characters are thus returned by the handler 
in lOPS ASCII mode. 

All illegal punch configurations (i.e., those not appearing in the 029 or 026) cause an IOPS4 error. In response to the 
error, the user can: 

(a) correct the card, reinsert it into the reader input hoppers, and type CTRL R to restart the read operation; 

(b) attempt to restart read (CTRL R) without correcting the card; 

(c) remove the card from the read hopper and restart read (CTRL R). 

The single addition to the Hollerith set, one made necessary by the constraints of system programs, is the provision 
for the internal generation of the ALT MODE terminator. The appearance of a 12-1-8 punch (multiple-punched A/8) 
on the card is mapped into the standard PDP-15 ALT MODE character (IVSg ) in the user's line. 

When card processing is complete, word 1 of the header is constructed and stored in the caller's line buffer area. Word 
2 of the header, the checksum location, is never disturbed by the card reader handler in lOPS ASCII mode. 

Refer to Appendix B for a listing of legal Hollerith codes and their corresponding ASCII graphics. 

c. Recoverable Errors 



I0PS4 ™ Reader Not Ready 



(1) Hopper Empty 

(2) Stacker Full 

(3) Feed check, LIGHT CHECK (may be hardware failure) 

(4) Read Check, DARK FAIL (may be hardware failure) 

(5) Reader not ready: 

(a) Stop button depressed. 

(b) Start button not depressed. 

(6) Validity check. 

(7) Pick Fail card selected but not passed from hopper to read stations. 
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d. Unrecoverable Errors 






IOPS6 - Illegal Function 








(1) 


.ENTER 




(2) 


.CLEAR 




(3) 


.WRITE 




(4) 


.TRAN 



e. Program Size 

CDB. occupies 410i o locations. 

f. Assembly Procedures 

CDB. exists in the I/O Library in a version which recognizes DEC 029 code (Appendix B). It also is supplied to the 
user as a source tape to allow an alternate assembly of the handler which will recognize DEC 026 code. 

The following is the procedure for assembhng CDB. in 026 mode: 

(1) Prepare to assemble the CDB. source tape using MACRO-15 with the "P" option.* 

(2) Enter the following parameter on the Teletype: 
DEC026 = 1 (CTRL D) 

(3) After assembly, remove the end-of-file (EOF) block from the new CDB. tape by using PIP with the "W" 
switch option. 

(4) This tape becomes the first tape in the I/O Library. 



4.4.5 LPA-(647 LINE PRINTER) 

a. Function 
Mnemonic Code 

•INIT 1 (1) 

(2) 
(3) 



Action 

Return standard line buffer size (52j o ) 
.SETUP - API channel register 563 
Clear line printer buffer 



(4) Form feed 



*Assembly without the "P" option produces the 029 version of the handler. 
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Mnemonic 


Code 




Action 


.DLETE 


9 
^ 


Ignored 


.RENAM 


2 




Ignored 


.FSTAT 


2 


Ignored 


.SEEK 


3 




I0PS6 - Illegal function 


.ENTER 


4 




Ignored 


.CLEAR 


5 




Ignored 


.CLOSE 


6 


(1) 


Allow previous output to terminate 






(2) 


Form feed 






(3) 


Allow form feed to terminate 


.MTAPE 


7 




Ignored 


.READ 


10 




I0PS6 - Illegal function 


.WRITE 


11 


(1) 


Allow previous output to terminate 






(2) 


Output line 


.WAIT 


12 




Allow previous output to terminate 


.TRAN 


13 




IOPS6 - Illegal function 


b . L egal Da ta Mo des 








lOPS ASCII 








(mode 2) 









c. Vertical Control Characters (when first character of line) 
1 2 Print every line 

2 1 Print every second line 

22 Print every third line 



13 

23 
24 



Print every sixth line 
Print every tenth line 
Print every twentieth line 
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20 
14 



Overprint 
Form feed 



d. Horizontal Control Characters (anywhere in line) 



11 



Horizontal tab - converted to N spaces, where N is the number necessary to have the next 
character in column 11, 21, 31, 41, ... 



e. Recoverable Errors 

Device not 
ready 

f. Unrecoverable Errors 



Monitor error message, .IOPS4. Make device ready, then type CTRL R 
to continue. 



Illegal function 



Illegal data 
mode 



Ml ^tor error message, .I0PS6 XXXXXX, where XXXXXX is address 
of ror CAL. 

(1) .SEEK 

(2) .READ 

(3) TRAN 

Monitor error message, .IOPS7 XXXXXX, where XXXXXX is address 
of error CAL. 

Any mode other than lOPS ASCII. 



g. Program Size 

297 (decimal) registers. 

4.4.6 MTF. (TU20, TU20A, TU30, TU30A Tape Transports) 

a. Introduction 

MTF. is a general magnetic tape I/O handler intended principally to meet the immediate needs of PDP-15 FORTRAN 
users. It will accept data-transfer requests in data modes used by the FORTRAN IV Object Time System and in 
addition, will honor the following FORTRAN statements; 

REWIND u 

ENDFILE u 

BACKSPACE u 
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The magnetic tape facility is also available, via MTF., to MACRO-15 users. It should be noted, however, that legal 
data modes and functions are limited to those required in the FORTRAN environment and the special 9-channel 
dump mode. 



b. Functions 
Mnemonic 
.INIT 



Code 

1 



Action 

(1) Return standard buffer size (56 lo = 708). 

Call .SETUP for API channel 45, if first time through. 



(2) 
(3) 



Set transfer direction for drive referenced. Direction is specified by bit 
8 of CAL instruction: 



-\ 



Bit 8 = 1 , this drive is output; 
Bit 8 = 0, this drive is input. 

(4) Set default conditions for this drive, viz: 

(a) This drive will transfer in odd parity. 

(b) This drive will transfer at 800 BPI. 

(c) This drive is 7-channeL* 



.OPER 


2 




Ignored 


.FSTAT 
.DLETE 


2 
2 




Ignored 
Ignored 


.RENAM 


2 


J 


Ignored 


.SEEK 


3 




(1) 



(1) If the specified drive has been INITed and transfer direction is input, 
return to caller. 

(2) If the specified drive has been INITed and transfer direction is not 
input, IOPS6, 

(3) If the specified drive has not been INITed and transfer direction is 
input, perform .INIT for this drive (input). 



.ENTER 



4 (1) If the specified drive has been INITed and transfer direction is output 

return to caller. 



*Unless the assembly parameter had been used to change the default assumption to 9-channel. Variable MT9CHN need only be defined 
for 9-channel paper-tape systems. 
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b. Functions (cont) 
Mnemonic Code 



.MTAPE 



Action 

(2) If the specified drive has been INITed and transfer direction is not 
output, IOPS6. 

(3) If the specified drive has not been INITed and transfer direction is 
output, perform .INIT of this drive (output). 



.CLEAR 


5 




Ignored 


.CLOSE 


6 


(1) 


Wait for current I/O to complete 






(2) 


Is this drive an input drive? 



Yes: return to caller. 

No: continue. 

(3) Is this drive open for transfers? 

No: return to caller. 

Yes: continue. 

(4) Write two EOF markers (7-channel = ITg; 9-channel = 238), hang 
on CAL during transfers. 

(5) Backspace one record, hang on CAL during backspace. This positions 
the read head between the two EOF markers written. 

(6) Set switch indicating this drive is not open for transfers. 

(7) Return to caller at CAL + 2 

(1) Wait for current I/O to complete. 

(2) Interpret subfunction (bits 5-8) of CAL instruction. 
Subfunctions: 

- Rewind 

(a) Set indicator that I/O \?.not underway. 

(b) Issue rewind to this drive. 

1 - Undefined 
I0PS6. 

2 - Backspace Record 
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Mnemonic Code Action 



(a) Set indicator that I/O is underway. 

(b) Issue backspace-one-record to this drive. Note: the backspace is 
attempted at the density currently assigned to this drive (via .INIT or 
.MTAPE 10-17). 

3 ~ Backspace File 
Illegal: I0PS6 

4 - Write EOF 

5 ~ Space Forward Record 

(a) Check I/O transfer direction for this drive. 

i. Output: I0PS6 
ii. Input: continue. 

(b) Set indicator that I/O is underway 

(c) Issue space-forward-one-record to this drive. 

6 - Space Forward File 
Illegal: IOPS6 

7 - Space to Logical EOT 
Illegal: lOPS error, code 6. 

10-17 - Describe Tape Configuration 

Update format descriptor bits for this drive. Note that these bits will 
be reset by any subsequent .INIT to this drive. 

I/O transfers (including space operations) will be performed in the 
parity, density, and channel-count specified in .MTAPE 10-17, thus: 

10:7-channel, even, 200 BPI 

1 1 :7-channel, even, 556 BPI 

12:7-channel, even, 800 BPI 

14:7-channel,odd, 200 BPI 

15:7-channel,odd, 556 BPI 

16:7-channel,odd, 800 BPI 

13:9-channel,even, 800 BPI 

17:9-channel,odd, 800 BPI 



.READ 10 ( 1 ) Wait for current I/O to complete. 
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Mnemonic Code Action 

(2) Ensure that requested drive is available (I0PS4 if not). 

(3) Parameters: 

(a) Buffer address: from CAL sequence 

(b) Word count (maximum): from CAL sequence 

(c) Tape format: from previous .INIT or .MTAPE 10-17. 

(4) Data Format: Data are transferred directly from magtape to the user's 
core buffer area. No editing of any kind is performed by MTF. 

(5) Parity Errors: Hardware parity errors during an input transfer cause the 
proper bits to be set in word of the line buffer header (bits 12-13 = 
01 if an error occurred). No reread is attempted. 

(6) End of File, End of Tape 

(a) End of File: When an end-of-file marker (EOF) is encountered on 
the tape being read, an EOF pseudo-line is constructed and stored 
in the user's line buffer area.* This EOF line consists of a two-word 
header and one data word, thus: 

header word 0: 002005 

header word 1: 775773 

data word 0: 000000 

data word 1 : Unchanged 

(b) Physical End of Tape: When an end-of-tape is encountered on the 
tape being read, an end-of-medium line is constructed and stored in 
the user's line buffer area.* The EOM line consists of a two-word 
header and one data word, thus: 

header word 0: 002006 

header word 1: 775772 

data word 0: 000000 

data word 1 : unchanged 

An attempt is then made to backspace over the record being read. 
The assumption is made that the record was written through the 
end-of-tape. 



.WRITE 11 ( 1 ) Wait for current I/O to complete. 

(2) Ensure that requested drive is available (lOPS 4 if not). 



*The action described takes place only if the I/O transfer had been performed in Mode or Mode 2 (see Section C). For error activity in 
Mode 5 transfers, see Section C.3. 
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Mnemonic 



Code 



Action 



.WAIT 



.WAITR 



.TRAN 



12 



13 



14 



c. Legal Data Modes 



(3) Parameters: 

(a) Line buffer address: from CAL sequence. 

(b) Word count: from bits 1-8 of line buffer header.* 

(c) Tape format: from previous .INIT or .MTAPE 10-17. 

(4) Data Format: Data are transferred directly from the user*s line buffer 
area to the device. No editing of any kind is performed by MTF. Each 
.WRITE results in exactly one physical record on tape. 

(5) Write errors: 5 attempts are made to rewrite the record. Before each 
attempt, a 3-inch length of tape is erased. If the fifth try is unsuc- 
cessful, an lOPS 4 return is made to the monitor. The user then has 
the option of trying to write 5 more times (CTRL R) or restarting 
with a fresh tape. 

(6) End of Tape: When EOT is detected during writing, an error return 
(lOPSl 5) is made to the monitor. 

( 1 ) Wait for current I/O to complete. 

(2) Return to CAL + 2 

Determine whether current I/O is complete. 

(1) If I/O is incomplete, transfer to location specified in CAL + 2. 

(2) If I/O is complete, return to CAL + 3. 

The .TRAN request (for forward-direction Transfers only) is honored 
and results in a binary transfer from or to the next physical record on 
tape. The device-address agreement in the CAL sequence (CAL + 2) is 
ignored by the .TRAN processor. 



(1) lOPS Binary (Mode 0) - 7 or 9 channel transports 

(2) lOPS ASCII (Mode 2) - 7 or 9 channel transports 

(3) 9-Channel Dump (mode 5) - 9 channel transports only. 

(a) This mode is designed to take advantage of all 8 data bits in each 
frame of 9-channel tape and thus ensure maximum throughput for 



*In Modes and 2 only (see Section C). For Mode 5 transfers, the word count is taken from the CAL sequence. 
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Mnemonic 



Code 



Action 

each word transferred. Whereas normal (Modes and 2) transfers 
require three tape frames for each PDP-15 register, transfer in Mode 
5 require only two frames per word. Only 16 bits of each PDP-15 
word, however, are read from or written on tape. Word format for 
Mode 5 is described below: 

Parity Bits (Pq, Pi): Bits and 1 of the PDP-15 word are used 
as parity bits for the 2 8-bit data bytes (Dq and D^), 
respectively, in the low-order portion of the register. During an 
output (write) transfer, these bits are ignored. The hardware will 
generate the proper parity for each data frame. During an input 
(read) transfer, these bits are set to the actual parity values for 
the two data frames as read from tape. 

Data Bytes (Dq, Dj): Bytes 2-9 and 10-17 hold the values of 
two adjacent 8-bit frames. During reads and writes, Dq is the 
first frame transferred. If a record containing an odd number of 
frames is read, the final frame is stored in Dq ; D, is set to binary 
zeroes. An even number of frames are always written during an 
output operation. 

(b) Error Treatment in Mode 5 

Because no line-buffer header is present in data transferred in Mode 
5, there is presently no facility for indicating I/O errors to the user 
program, particularly during input transfers. MTF. will do its best 
to transfer correct data but, if it fails, cannot so inform the calling 
program. 

Read Errors 

Parity Errors: 5 attempts are made to reread the error record. If 
the record cannot be read successfully, the data resulting from 
the fifth reread attempt are left in the user's buffer area. 

Buffer Overflow: If the number of words in the record being 
read exceeds the count given in the CAL sequence, transfer is 
halted. 



End of Fife: No data are transferred. The read head is 
positioned preceding the EOT reflective spot. 

Write Errors 

As described in paragraph e. under .WRITE. 

(c) Restrictions 

Mode 5 is a legal I/O mode only if the referenced transport is 
9-channeI. An attempt to use Mode 5 in reading or writing a 
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Mnemonic 



Code 



Action 



7-channel drive results in an error return (I0PS7) to the Monitor. 
Requests for transfers in modes other than 0, 2, and 5 result in 
error returns (I0PS7) to the Monitor. 



d. Program Size 



MTF. currently occupies 1 1448 PDP-15 registers. 
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